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提要 


本 书 详细 解释 ASP.NET Core MVC 的 架构 、 功 
能 和 应 用 ， 深 入 阐述 构建 现代 可 扩展 的 Web 应 用 程 
序 的 工具 、 技 术 和 方法 ， 揭 示 如 何 为 .NET Core 平 
台 创 建 轻型 的 移动 端 应 用 程序 。 本 书 主要 内 容 包括 
MVC 模 式 、C# 基 本 特性 、Razor、Visual Studio, 
MVC 应 用 程序 的 单元 测试 、 实 际 应 用 程序 的 创建 、 
URL 路 由 、 高 级 路 由 特性 、 控 制 医 、 依 赖 注入 、 过 
eae. API as. MA. MAA. MEDEF, 
模型 绑 定 、 模 型 验证 、ASP.NET Core Identity. t# 
型 约定 和 操作 约束 等 。 


本 书 适 合 .NET 开 发 人 员 和 Web 开发 人 员 阅 
读 ， 也 可 供 计算 机 相关 专业 的 师 生 阅读 。 
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本 书 是 ASP.NET 方 面 的 畅销 书 ， 作 者 Adam 
Freeman 在 本 书 里 对 ASP.NET Core MVC 进 行 了 详细 
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一 部 分 ASP.NET Core MVC 


ASP.NET Core MVC 对 于 使 用 微软 平台 的 Web 
开发 人 员 来 说 是 一 次 彻底 的 转变 。 它 强调 清晰 的 染 
构 、 设 计 模 式 和 可 测试 性 ， 并 且 不 会 试图 隐藏 Web 
WN CPE 77 sXe 





本 书 第 一 部 分 由 在 介绍 MVC 开 发 的 基本 概 
4, #45 ASP.NET Core MVC 中 的 新 功能 ， 并 在 实 
践 中 体验 框架 的 使 用 方式 。 


第 1 音 ASP.NET Core MVCH = 


ASP.NET Core MVC 是 一 个 来 自 微软 的 Web 应 

用 程序 开发 框架 ， 它 结合 了 模型 -视图 -控制 器 
(MVC) 体系 结构 的 有 效 性 和 整洁 性 、 敏 捷 开发 的 

想法 和 技术 ， 以 及 .NET 平 台 的 最 佳 部 分 。 在 本 章 
中 ， 你 将 了 解 微软 创建 ASP.NET Core MVC 的 原 
央 ， 看 看 它 如 何 与 其 前 里 和 蔡 代 品 进行 比较 。 最 
后 ， 本 章 将 概述 ASP.NET Core MVC 中 的 新 特性 以 
及 本 书 所 涵盖 的 内 容 。 











1.1 ASP.NET Core MVC 的 历史 


最 早 的 ASP.NET 是 在 2002 年 推出 的 ， 当 时 微软 
热衷 于 保护 其 在 传统 果 面 应 用 程序 开发 中 的 主导 地 
位 ， 并 将 互联 网 视 为 威胁 。 图 1-1 说 明了 当时 出 现 








的 ASP.NET Web Forms 技 术 栈 。 


ASPNET Web Forms 
一 组 UI 组 件 (页 面 、 按 钮 等 ) 加 一 个 





有 状态 的 、 面 向 对 象 的 GUI 编程 模型 


ASPNET 


在 11S( 微 软 Web Server 产 品 ) 中 托管 NET 应 用 
程序 的 方法 ， 使 您 与 HITP 请 求 和 响应 能 够 交互 





.NET 


-个 多 语言 管理 的 代码 平台 
(在 当时 是 全 新 的 ， 它 本 身 就 是 一 个 里 程 碑 ) 





图 1-1 ASP.NET Web Forms 技 术 栈 


1.1.1 ASP.NET Web Forms 


微软 试图 使 用 ASP.NET Web Forms 将 用 户 界 面 
(User Interface, UL) 模拟 为 服务 器 端 控件 对 象 
层 ， 隐 藏 超 文本 传输 协议 HTTP 〈 本 吴 是 无 状态 
的 ) 和 超 文本 标记 语言 HIML (当时 许多 开发 人 员 
HELPAR) 。 每 个 控件 在 请 求 之 间 保 持 目 己 的 
状态 ， 在 需要 时 自动 泻 染 为 HTML， 并 将 客户 问 事 
件 〈《 如 按钮 单 击 ) 与 服务 器 端 相 应 的 事件 处 理 程 序 








代码 相关 联 。 实 际 上 ，Web 窗 体 是 一 个 巨大 的 抽象 
层 ， 旨 在 通过 Web 传 递 经 典 的 事件 张 动 的 图 形 用 户 
界面 〈Graphics User Interface, GUI) 。 





其 思想 是 使 Web 开发 的 体验 与 开 及 时 面 应 用 程 
序 一 致 。 开 有 人员 可 以 基于 有 状态 的 用 户 界 面 进 行 
考虑 ， 而 无 须 使 用 一 系列 独立 的 HTTP 请 求 和 响 
Mo WEKA DA Windows HF ACA R [al it Ae Web 
应 用 程序 开发 领域 实现 无 颖 转型 。 








ASP.NET Web Forms 存 在 的 问题 


传统 的 ASP.NET Web Forms 开 发 从 原则 上 来 说 
曾经 很 好 ， 但 事实 证 明 它 更 加 复杂 。 








e View State 权 重 : 路 请 求 维 护 状 态 的 实际 机 制 
( 称 为 “View State”) AERP ving MARS AZ 
间 传 输 大 量 数据 。 即 使 是 大 小 适中 的 Web 应 用 
程序 ， 这 些 数据 也 可 能 会 达到 儿 百 生字 节 ， 并 








且 每 次 请 求 都 会 来 回 传递 数据 ， 从 而 导致 啊 应 
时 间 更 慢 ， 并 增加 了 服务 器 的 带宽 需求 。 

。 页 面 生 命 周期 : 连接 客户 端 事件 与 服务 右 端 事 
件 处 理 程序 代码 《页 面 生命 周期 的 一 部 分 ) 的 
机 制 可 能 会 变 得 复杂 和 理 手 。 很 少 有 开发 人 员 
在 不 产生 View State 错 误 或 友 现 某 些 事件 处 理 程 
序 真 名 失败 的 情况 下 ， 能 在 运行 时 成 功 操纵 控 
件 层 。 

。 关注 点 分 离 的 错误 理念: ASP.NET Web Forms 
的 代码 隐藏 模 型 提供 了 将 应 用 程序 代码 从 HTML 
标记 中 移 除 到 单独 的 代码 隐藏 类 中 的 方法 。 这 
是 为 了 分 离 罗 辑 层 和 表现 层 ， 但 实际 上 ， 又 鼓 
励 开 发 人 员 将 表现 层 代 码 《〈 如 操纵 服务 磺 端 控 
件 树 ) 与 其 应 用 程序 逻辑 (如 操纵 数据 库 数 
据 ) 混在 这 些 怪异 的 后 台 代 人 码 类 中 。 最 终 的 结 
果 可 能 是 难以 理解 的 。 

。 对 HITML 的 有 限 控 制 : ARS hee HE By EN 
为 HTML， 但 不 一 定 是 你 想 要 的 HTML。 在 
ASP.NET 的 早期 版 本 中 ，HTML 输 出 无 法 符合 
Web 标 准 ， 或 者 不 能 很 好 地 利用 层 登 样式 表 























(CSS) ， 并 且 服 务 器 控件 生成 难以 预测 旦 复杂 
的 ID 属性 ， 这 些 属性 难以 使 用 JavaScript 访 问 。 
这 些 问 题 在 最 近 的 ASP.NET Web Forms 版 本 中 
有 所 改进 ， 但 是 获取 你 期 望 的 HTML 仍 然 是 比较 
困难 的 。 

有 漏洞 的 抽象 : ASP.NET Web Forms 尺 可 能 隐 
藏 HTML 和 HTTP。 当 你 符 试 实现 自 定 义 行为 
时 ， 你 经 常会 放弃 抽象 ， 这 迫使 你 对 回 发 事件 
机 制 进行 逆向 工程 ， 或 执行 笨拙 的 操作 以 使 其 
生成 所 需 的 HTML。 

低 可 测试 性 ，ASP.NET Web Forms 的 设计 人 员 
无 法 预料 到 自动 测试 将 成 为 软件 开发 的 重要 组 
成 部 分 。 他 们 设计 的 紧密 粳 合 架构 不 适合 单元 
测试 。 集 成 测试 也 可 能 是 一 个 挑战 。 

















ASP.NET Web Forms 并 非 一 无 是 处 ， 实 际 上 ， 
微软 为 提高 标准 合 规 性 和 简化 开发 流程 付出 了 巨大 
的 努力 ， 甚 至 从 原始 的 ASP.NET MVC 框 架 中 获取 
了 一 些 功 能 ， 并 将 其 应 用 于 ASP.NET Web Forms。 





当 你 需要 快速 的 结果 时 ，ASP.NET Web Forms 表 现 
优异 ， 你 可 以 在 一 天 内 拥有 一 个 相当 复杂 的 Web 应 
用 程序 。 但 除非 你 在 开发 过 程 中 足够 小 心 ， 否 则 你 
会 发 现 你 创建 的 应 用 程序 难以 测试 和 维护 。 


1.1.2 起初 的 MVC 框 架 


2007 年 10 月 ， 微 软 友 布 了 一 个 基于 现 有 
ASP.NET 平 台 的 新 开发 平台 ， 虽 在 直接 回应 对 
ASP.NET Web Forms 的 批评 和 竞争 平台 〈 如 Ruby 
on Rails) 的 普及 。 新 平台 称 为 ASP.NET MVC 框 
架 ， 并 反映 了 Web 应 用 程序 开发 的 新 兴 趋 势 ， 如 
HTML 和 CSS 标 准 化 、REST Web 服 务 、 有 效 的 单元 
测试 以 及 开 有 人员 应 该 接受 HTTP 的 无 状态 特性 的 
想法 。 











文 持 最 初 MVC 框 架 的 概念 现在 看 起 来 很 目 然 
而 且 显 而 易 见 ， 但 是 它们 在 2007 年 的 .NET Web 开 





发 世界 中 是 缺乏 的 。ASP.NET MVC 框 架 的 引入 使 
微软 的 Web 开 发 平台 重新 回 到 了 现代 。 








MVC 框 架 还 表明 微软 的 态度 及 生 了 重大 变 
化 ， 微 软 以 前 曾 试 图 控制 Web 应 用 程序 工具 链 中 的 
每 个 组 件 。 现 在 微软 基于 jQuery 等 开源 工具 构建 了 
MVC 框 架 ， 从 竞争 〈 并 且 更 为 成 功 的 ) 平台 中 获得 
设计 约定 和 最 佳 实践 ， 并 将 源 代 码 发 布 到 MVC 框 
， 供 开 有 人员 审 否 








起 初 的 MVC 框 架 存 在 的 问题 


微软 在 创建 MVC 框 架 时 ， 基 于 现 有 的 
ASP.NET 平 台 ， 这 是 有 道理 的 ， 因 为 该 平台 具有 很 
多 固有 的 底层 特性 ，ASP.NET 开 发 人 员 都 熟知 和 理 


解 这 些 特性 。 








但 是 ， 将 MVC 框 架 移植 到 最 初 为 ASP.NET 


Web Forms 设 计 的 平台 上 是 需要 受 协 的 。MVC 框 架 
开发 人 员 逐 渐 襄 欢 使 用 配置 设置 和 代码 调整 ， 来 茶 
用 或 重新 配置 对 Web 应 用 程序 没有 任何 影响 但 对 整 
个 程序 正常 工作 来 说 必需 的 特性 。 








随 着 MVC 框 架 的 普及 ， 微 软 开 始 将 一 些 核心 
功能 添加 到 ASP.NET Web Forms 中 。 结 果 越 来 越 不 
相 匹 配 ， 其 中 需要 用 来 文 持 MVC 框 架 的 独特 设计 特 
性 被 扩展 到 支持 ASP.NET Web Forms， 却 为 了 让 所 
有 的 东西 融合 在 一 起 而 让 设计 变 得 更 加 不 相 匹 配 。 
同时 ， 微 软 开 始 使 用 创建 Web 服 务 (Web API) 和 
实时 通信 CSignalR) 的 新 框架 来 扩展 ASP.NET。 新 
的 框架 添加 了 自己 的 配置 和 开发 约定 ， 每 个 都 有 自 
己 的 优点 和 特异 之 处 ， 结 果 导 致 了 零乱 的 混乱 状 
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1.2 ASP.NET Core 


2015 年 ， 微 软 公 布 了 ASP.NET 和 和 MVC 框架 的 
新 方 铝 ， 也 就 是 本 书 要 讨论 的 主题 ASP.NET Core 
MVC. 





ASP.NET Core 基 于 .NET Core 构 建 ， 它 是 .NET 
Framework 的 跨 平 台 版 本 ， 没 有 Windows 平 台 特 定 
的 应 用 程序 编程 接口 (Application Programming 
Interface，API) 。 虽 然 windows 仍 然 是 主要 的 操作 
系统 ， 但 Web 应 用 程序 越 来 越 多 地 托管 在 云 平台 的 
小 型 而 简单 的 容器 中 ， 并 且 通 过 采用 器 平台 方法 ， 
微软 扩展 了 .NEI 的 黎 兰 面 ， 使 得 ASP.NET Core 
用 程序 能 够 部 闭 到 更 广泛 的 托管 环境 中 。 另 外 ， 
ASP.NET Core 还 有 一 个 额外 的 优点 一 一 开 友 人 员 可 
以 在 Linux 系 统 和 macOS 上 创建 ASP.NET Core Web 
应 用 程序 。 


ASP.NET Core 是 一 个 全 新 的 框架 。 它 更 简单 、 
更 容易 处 理 ， 并 日 没有 来 自 ASP.NET Web Forms 的 





遗留 问题 。 另 外 ， 由 于 它 基 于 .NET Core, WAKE 
文 持 在 一 系列 平台 和 容器 上 进行 Web 应 用 程序 开 
Tee 

ASP.NET Core MVC 提 供 了 基于 新 的 ASP.NET 
Core 平 台 构 建 的 初始 ASP.NET MVC 框 架 的 功能 。 
它 集成 了 以 前 由 Web API 提 供 的 功能 ， 能 以 更 自然 
的 方式 生成 复杂 内 容 ， 并 且 使 关键 开发 任务 〈 如 单 
元 测试 ) 更 简单 。 





1.2.1 ASP.NET Core MVC 2 的 新 特性 





ASP.NET Core MVC 2 的 发 布 版 本 重点 关注 整 
合 ， 它 在 早期 版 本 中 引入 了 一 些 工 具 和 平台 变更 。 
ASP.NET Core MVC 2 需要 .NET Core 2， 它 具有 很 
多 扩展 的 API， 现 已 在 其 他 Linux 友 行 版 上 受到 文 
持 。 有 用 的 变化 包括 一 个 新 的 元 数据 包 系 统 〈 它 简 
化 了 NuGet 包 的 管理 ) ， 一 个 新 的 ASP.NET Core 配 


置 系统 ， 以 及 对 Entity Framework Core 2 的 支持 。 最 
重要 的 新 功能 是 Razor Pages， 它 尝试 重新 构建 应 
用 ， 并 使 用 更 现代 的 平台 创建 与 Web Pages 相 天 的 
开发 风格 ， 但 MVC 开 发 人 员 对 Razor Pages 并 不 感 兴 
趣 《〈 因 而 在 本 书 中 没有 摘 述 ) 。 


1.2.2 ASP.NET Core MVC 的 主要 优点 


本 节 将 简要 介绍 新 的 MVC 平 台 如 何 克 服 
ASP.NET Web Forms 和 初始 MVC 框 架 的 遗留 问题 ， 
以 及 如 何 完善 ASP.NET。 


1. MVC 架构 


ASP.NET Core MVC 遵 循 称 为 模型 -视图 -控制 
器 (MVC) 的 模式 ， 指 导 ASP.NET Web 应 用 程序 
及 其 包含 的 组 件 之 间 的 交互 。 


区 分 MVC 架 构 模 式 和 ASP.NET Core MVC 实 现 


很 重要 。MVC 模 式 并 不 新 髓 ， 它 可 以 仍 调 到 1978 年 
Xerox PARC 的 Smalltalk 项 目 ， 但 是 它 作 为 Web 应 用 
程序 的 一 种 开发 模式 ， 已 经 得 到 了 广泛 普及 ， 原 因 
uF 

。 用 户 与 遵守 MVC 模 式 的 应 用 程序 进行 交互 是 遵 
循 自 然 循 环 的 。 用 户 执 行 一 个 动作 ， 应 用 程序 
进行 啊 应 ， 更 改 其 数据 模型 并 同 用 户 传递 更 新 
的 视图 。 然 后 重复 这 一 循环 。 这 对 作为 一 系列 
HTTP 请 求 和 响应 来 传输 的 Web 应 用 程序 来 说 非 
常 合适 。 

。Web 应 用 程序 需要 组 合 几 种 技术 例如 数据 
库 、HTML 和 可 执行 代码 等 ) ， 通 常 分 为 一 系列 
层次 。 这 些 组 合 产 生 的 模式 会 自然 地 映射 到 
MVC 模 式 的 概念 上 。 











ASP.NET Core MVC 实 现 了 了 MVC 模式 ， 与 
ASP.NET Web Forms 相 比 ，ASP.NET Core MVC 极 
大 改善 了 关注 点 的 分 离 。 实 际 上 ，ASP.NET Core 


MVC 实 现 了 MVC 模 式 的 变 体 ， 特 别 适用 于 Web 应 
用 程序 。 你 将 在 第 3 章 中 更 多 地 了 解 此 以 构 的 理论 
和 实践 。 





2. 可 扩展 性 


ASP.NET Core 和 ASP.NET Core MVC 已 构建 为 
一 系列 具有 明确 特征 的 独立 组 件 ， 能 满足 .NET 接 口 
的 需求 ， 也 可 构建 在 抽象 基 类 上 。 你 可 以 轻松 地 用 
A CLA SE SRK BEA HF ORL, ASP.NET 
Core MVC 为 每 个 组 件 提供 了 以 下 3 个 选项 。 


。 使 用 组 件 的 默认 实现 〈 对 于 大 多 数 应 用 程序 来 
识 应 该 是 足够 的 ) 。 

© 从 默认 实现 派生 一 个 子 类 来 调整 其 行为 。 

。 使 用 接口 或 抽象 基 类 的 新 实现 完全 蔡 换 组 件 。 











你 将 从 第 14 草 开始 ， 了 解 各 种 组 件 、 如 何 蔡 换 
以 及 为 什么 要 调整 或 痊 换 每 个 组 件 。 


3. 严格 控制 HIML 和 HTTP 


ASP.NET Core MVC 能 够 生成 清晰 、 符 合 标准 
的 标签 。 它 的 内 置 标签 帮助 器 能 产生 符合 标准 的 输 
出 ， 但 与 ASP.NET Web Forms 相 比 ， 有 更 重要 的 理 
念 上 的 变化 。ASP.NET Core MVC 并 不 会 生成 一 些 
难以 控制 的 HIML 控 件 ， 而 是 或 励 你 创建 简单 而 优 
雅 的 标签 ， 并 使 用 CSS 进 行 样式 化 。 





当然 ， 如 果 你 想 要 为 诸如 日 期 选择 强 或 级 联 末 
单 之 关 的 复杂 UI 元 际 使 用 一 些 现成 的 小 部 件 ， 那 么 
ASP.NET Core MVC 采 用 的 “无 特定 要 求 ” 方 法 可 以 
很 轻松 地 使 用 各 种 最 佳 组 合 的 客户 正 库 ， 如 
jQuery、Angular 或 Bootstrap CSS 库 。ASP.NET Core 
MVC 与 这 些 库 相互 配合 得 很 好 ， 人 微软 已 包含 这 些 模 
板 以 局 动 新 的 开 及 项 目 。 

















ASP.NET Core MVC 与 HTTP 协 调 工 作 。 你 可 以 


控制 在 浏览 器 和 服务 器 之 间 传 递 的 请 求 ， 因 此 你 可 
以 根据 需要 调整 用 户 体验 。 使 用 Ajax 更 加 容易 ， 
创建 Web 服务 来 接收 浏览 器 HTTP 请 求 是 一 个 简 
单 的 过 程 。 








4. 可 测试 性 


ASP.NET Core MVC 架 构 在 使 应 用 程序 变 得 可 
维护 和 可 测试 方面 提供 了 良好 的 开端 ， 因 为 你 可 以 
将 不 同 的 应 用 程序 关注 点 目 然 地 分 离 成 独立 的 部 
分 。 此 外 ，ASP.NET Core 平 台 和 ASP.NET Core 
MVC 框 染 的 每 个 部 分 都 可 以 为 单元 测试 进行 隔离 和 
蔡 换 ， 可 以 使 用 任何 流行 的 开源 测试 框架 如 
xUnit) 。 








在 本 书 中 ， 你 将 看 到 如 何 为 ASP.NET MVC 控 
制 器 编写 整洁 、 简 单 的 单元 测试 示例 。 为 了 模拟 各 
种 场景 ， 这 些 示 例 使 用 各 种 测试 和 模拟 策略 来 文 持 





框架 组 件 的 虚构 或 模拟 实现 。 即 使 你 以 前 从 来 没有 
写 过 单元 测试 ， 这 也 是 一 个 很 好 的 开始 。 


可 测试 性 不 仅仅 是 单元 测试 的 问题 。ASP.NET 
Core MVC 应 用 程序 也 可 以 与 UI 目 动 化 测试 工具 一 
起 使 用 。 你 可 以 编写 模拟 用 户 交 互 的 测试 脚本 ， 而 
不 需要 猜测 框架 将 生成 哪些 HTML 元 素 结 构 、CSS 
类 或 ID， 你 不 必 担 心 页 面 结构 发 生意 外 的 变化 。 





5. 强大 的 路 由 系统 


统一 资源 定位 器 CURL) 的 风格 随 着 Web 应 用 
技术 的 发 展 而 发 展 ， 比 如 ， 以 下 URL 越 来 越 少见 。 


取而代之 的 是 一 种 更 简单 、 更 干净 的 格式 : 


采用 这 种 URL 结 构 有 一 些 很 好 的 理由 。 第 一 ， 
搜索 引擎 会 对 URL 中 找到 的 关键 字 加 权 。 搜 索 “rent 
in Chicago”( 芝 加 哥 租 房 ) 更 有 可 能 找到 更 简单 的 
网 址 。 第 和 二， 许多 网 络 用 户 现 在 已 经 足够 了 解 
URL， 并 乐于 通过 在 浏览 器 的 地 址 栏 中 键入 导航 选 
项 。 第 三 ， 当 人 们 理解 URL 的 结构 时 ， 才 更 有 可 能 
链接 它 ， 与 朋友 分 译 ， 甚 至 通过 手机 表 读 。 第 四 ， 
它 不 会 回 公 共 Intermet 雄 露 你 的 应 用 程序 的 技术 细 
节 、 文 件 夹 和 文件 名 结构 ， 因 此 你 可 以 目 由 地 更 改 
故 层 的 实现 ， 而 不 会 破坏 所 有 的 传 入 链接 。 











整洁 的 URL 在 早期 的 框架 中 很 难 实现 ， 但 
ASP.NET Core MVC 默 认 使 用 称 为 URL 路 由 的 功能 
来 提供 整洁 的 URL。 这 样 可 以 控制 你 的 URL 模 式 及 
其 与 应 用 程序 之 间 的 关系 ， 自 由 地 为 用 户 创 建 有 意 
义 和 有 用 的 URL 模 式 ， 而 无 须 遵守 预定 义 模 式 。 当 
然 ， 这 意味 着 你 可 以 轻松 地 定义 一 种 现代 REST 风 





格 的 URL 模 式 。 


6. 现代 API 








微软 的 .NET 平 台 随 每 个 主 版 本 的 发 展 而 发 展 ， 
文 持 甚 至 定义 了 现代 编程 的 最 新 方向 。ASP.NET 
Core MVC 是 为 .NET Core 构 建 的 ， 因 此 其 API 可 以 
充分 利用 C# 程 序 员 熟悉 的 语言 和 运行 时 创新 ， 包 括 
await 关 键 字 、 扩 展 方 法 、lambda 表 达 式 、 匿 名 和 动 
态 类 型 以 及 语言 集成 查询 (LINQ) 。 











许多 ASP.NET Core MVC API 方 法 和 编码 模式 
与 早期 平台 相 比 遵循 更 整洁 、 更 具 表 现 力 的 方式 。 
不 要 担心 ， 如 果 你 尚 不 了 解 最 新 的 C# 语 言 特性 ， 第 
4 章 会 提供 MVC 开 发 中 最 午 要 的 C# 特 性 总 结 。 








以 前 的 ASP.NET 版 本 特定 于 Windows 系 统 ， 需 
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Windows 服 务 嚣 才能 部 车 和 运行 它们 。 微 软 使 
ASP.NET Core 文 持 路 平台， 包括 开发 和 部 普 。 
ASP.NET Core 可 用 于 不 同 的 平台 ， 包 括 macOS 和 一 
系列 流行 的 Linux 发 行 版 。 跨 平台 文 持 使 得 部 署 
ASP.NET Core MVC 应 用 程序 变 得 更 加 容易 ， 并 且 
可 以 很 好 地 支持 应 用 程序 容 右 平台 ， 如 Docker 等 。 











当前 大 多 数 ASP.NET Core MVC 开 发 很 可 能 会 
使 用 Visual Studio 完 成 ， 但 微软 也 创建 了 一 个 名 为 
Visual Studio Code 的 里 平台 开发 工具 ， 这 意味 看 
ASP.NET Core MVC 开 发 不 再 局 限于 Windows 平 
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8. ASP.NET Core MVC 是 开源 的 





与 以 前 的 Microsoft Web 开 发 平台 不 同 ， 你 可 以 
免费 下 载 ASP.NET Core 和 ASP.NET Core MVC 的 源 


代码 ， 甚 至 修改 和 编译 自 己 的 版 本 。 当 你 要 调试 跟 
踪 进 入 一 个 系统 组 件 并 希望 进入 其 代码 内 部 (甚至 
阅读 原始 的 程序 员 注 释 ) 时 ， 这 是 非常 有 价值 的 。 
如 末 你 正在 构建 一 个 局 级 组 件 ， 并 和 希望 了 解 进一步 
开发 的 可 能 性 ， 或 想 了 解 内 置 组 件 如 何 进行 实际 工 
作 ， 这 也 是 非常 有 用 的 。 





你 可 以 从 GitHub 下 载 ASP.NET Core 和 ASP.NET 
Core MVC 的 源 代 人 码 。 


1.3 ”预备 知识 


为 了 充分 利用 本 书 ， 你 应 该 熟悉 Web 开 发 的 基 
础 知识 ， 了 解 HTML 和 CSS 的 工作 原理 ， 并 掌握 C# 
的 相关 知识 。 如 条 你 对 客户 端 细 贡 《如 JavaScript) 
有 些 模糊 ， 请 不 要 担心 。 重 点 是 本 书 中 的 服务 器 并 
开发 ， 你 可 以 通过 示例 获取 所 雷 的 内 容 。 第 4 章 将 
尽 结 MVC 开 发 中 最 有 用 的 C#i 语 言 特性 ， 如 果 你 正 











在 从 早期 版 本 转 到 最 新 的 .NET 版 本 ， 你 将 发 现 它 们 
非常 有 用 。 


14 本 书 的 结构 


本 书 分 为 两 部 分 ， 每 一 部 分 都 涵 孟 了 一 系列 相 





本 书 第 一 部 分 将 从 ASP.NET Core MVC 的 背景 
开始 ， 解 释 MVC 模 式 的 优点 和 实际 影响 ， 介 绍 
ASP.NET Core MVC 的 功能 ， 并 描述 每 个 ASP.NET 
Core MVC 程 序 员 需 要 学 习 的 工具 和 C#i 语 言 功能 








在 第 2 间 中 ， 你 将 通过 创建 一 个 简单 的 Web 应 
用 程序 ， 深 入 了 解 主要 组 件 、 ee 们 如 何 
组 合 在 一 起 。 然 而 ， 本 书 第 一 部 分 主要 介绍 如 何 开 
发 一 个 名 为 SportsStore 的 项 目 ， ieee 目 ， 展 示 
从 开始 到 部 闭 的 实际 开发 流程 ， 并 介绍 ASP.NET 








Core MVC 的 主要 特性 。 





本 书 第 二 部 分 将 解释 用 于 构建 SportsStore 应 用 
程序 的 ASP.NET Core MVC 功 能 的 内 部 工作 原理 。 
该 部 分 将 展示 每 个 功能 如 何 工 作 ， 解 释 它 所 扮演 的 
角色 ， 并 展示 可 用 的 配置 和 目 定 义 选 项 。 eel 

部 分 介绍 广泛 的 背景 基础 ， 第 二 部 分 则 深入 讨论 





a z 


1.5 如 何 获 取 本 书 的 示例 代码 


在 GitHub 网 站 上 搜索 "pro-asp.net-core-mvc- 
2”， 即 可 下 载 本 书 所 有 章节 的 示例 代码 。 下 载 的 内 
容 不 需要 修改 ， 并 包含 所 有 必要 的 资源 。 











1.6 联系 作者 








如 果 你 在 使 用 本 书 的 示例 代码 时 过 到 问题 ， 或 
者 如 果 你 在 本 书 中 发 现 问 题 ， 你 可 以 通过 电子 邮件 


adam@adam- freeman.com 联 系 作 者 ， 作 者 会 尽力 帮 
助 你 。 
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本 章 介 绍 了 ASP.NET Core MVC 的 背景 以 及 它 
是 如 何 从 ASP.NET Web Forms 和 起 始 的 ASP.NET 
MVC 框 架 发 展 而 来 的 ， 曾 述 了 使 用 ASP.NET Core 
MVC 的 好 处 以 及 本 书 的 结构 。 在 下 一 章 中 ， 你 将 在 
一 个 简单 的 示例 程序 中 看 到 ASP.NET Core MVC 先 
进 的 特性 。 








第 2 章 ” 首 个 MVC 应 用 程序 


鉴赏 一 款 软件 开发 框架 的 最 佳 方式 就 是 深入 其 
中 并 使 用 它 。 在 本 章 中 ， 你 将 使 用 ASP.NET Core 
MVC 创 建 一 个 人 简单 的 数据 输入 应 用 程序 。 整 个 开 友 
过 程 可 分 解 为 多 个 小 的 步骤 ， 你 将 了 解 到 清晰 的 
MVC 应 用 程序 的 构造 。 当 然 为 了 简化 ， 也 会 跳 过 一 
些 技术 细节 。 但 别 担心 ， 如 果 你 是 MVC 新 人 ， 你 会 
发 现 许 多 感 兴趣 的 内 容 。 对 于 使 用 但 未 解释 的 部 
分 ， 本 章 也 会 提供 参考 引用 ， 以 便于 你 发 现 所 有 的 


ANT 。 














本 书 的 内 容 更 新 


微软 对 .NET Core 和 ASP.NET Core MVC 有 一 项 


活跃 的 开发 计划 ， 这 意味 看 在 你 阅读 本 书 时 可 能 会 
有 更 新 的 版 本 可 用 。 要 求 读者 每 隔 几 个 月 就 买 一 本 
新 书 是 不 现实 的 ， 尤 其 是 在 大 多 数 改 动 相 对 较 小 的 
情况 下 。 因 此 ， 作 者 将 免费 更 新 本 书 ， 并 将 内 容 放 
SEDGE: aAa ja 


Re 
尤其 是 因为 作者 不 知道 未 来 主要 版 本 的 ASP.NET 
Core MVC 将 包含 什么 ， 但 目标 是 通过 补充 包含 的 
示例 来 延长 本 书 的 寿命 。 作 者 无 法 承诺 这 些 更 新 会 
是 什么 样 的 ， 它 们 会 采取 什么 形式 ， 或 者 在 将 它们 
添加 到 本 书 的 新 版 本 之 前 ， 作 者 会 花费 多 长 时 间 。 
当 新 的 ASP.NET Core MVC 版 本 发 布 时 ， 请 保持 开 
放 的 心态 并 检查 本 书 的 GitHub 主 页 。 如 果 你 对 如 何 
改进 更 新 有 和 想法， 请 发 电子 邮件 至 adam@adam- 


freeman.com 。 





2.1 安装 Visual Studio 


本 书 使 用 的 集成 开发 环境 是 Visual Studio 
2017， 它 提供 了 使 用 ASP.NET Core MVC 时 所 需 的 
各 种 功能 。 本 书 中 的 示例 使 用 的 是 免费 的 Visual 
Studio 2017 社 区 版 本 ， 有 需要 的 读者 可 以 从 Visual 
Studio 官 网 下 载 。 当 你 安装 Visual Studio 时 ， 你 必须 
选择 .NET Core cross-platform development 选 项 ， 如 
图 2-1 所 示 。 





图 2-1 选择 .NET Core cross-platform development 选 项 


内 
v =A 
yE ee 


Visual Studio 20174 F ASP.NET Core MVC 2% 
布 。 如 采 你 已 为 早期 版 本 的 ASP.NET Core MVC% 
3% J Visual Studio， 则 必须 使 用 最 新 的 Visual Studio 
更 新 。 你 可 以 运行 Visual Studio 安 装 程序 ， 并 为 正 
在 使 用 的 Visual Studio 版 本 选择 Update 选 项 。 


fe ” 示 


Visual Studio 只 支持 Windows。 你 可 以 在 其 他 
平台 上 创建 ASP.NET Core MVC 应 用 程序 并 使 用 本 
Visual Studio 示 例 中 的 代码 ， 但 是 其 他 平台 可 能 
不 包含 本 书 示例 中 使 用 的 工具 。 





详情 可 参见 第 13 章 。 


2.2 #4. NET Core 2.0 SDK 


Visual Studio 2224, ASP.NET Core MVC 开 
发 所 需 的 所 有 功能 ， 但 不 包括 必须 单独 下 载 和 安装 
的 .NET Core 2.0。 


访问 微软 官网 ， 下 载 并 运行 适用 于 Windows 
的 .NET Core SDK 安 装 程序 。 执 行 完 安装 程序 后 ， 


打开 新 的 命令 提示 符 或 PowerShell 窗口 并 运行 以 下 
命令 以 显示 已 安装 的 .NET 版 本 : 


dotnet --version 


2.3 创建 新 的 ASP.NET Core MVC 项 日 


本 节 从 创建 一 个 新 的 ASP.NET Core MVC 项 目 
开始 讲述 。 在 左 侧 窗 格 中 从 File 荣 单 中 选择 
New = Project KF] F New Project 对 话 框 。 如 果 
你 选择 Installed > Visual C# ,Web， 你 将 看 到 
ASP.NET Core Web Application (.NET Core) 项 目 
模板 ， 按 照 图 2-2 选 择 项 目 类 型 。 

















图 2-2 ”选择 ASP.NET Core Web Application 项 目 模 板 


or 
提 om 


项 目 模板 的 选择 可 能 会 令 人 困惑 ， 因 为 它们 的 
名 称 非 常 相似 。ASP.NET Web Application (.NET 
Framework) 模板 会 使 用 ASP.NET 和 MVC 框 架 的 遗 
留 版 本 创建 项 目 ， 这 一 框架 早 于 ASP.NET Core. 7 
外 两 个 模板 用 于 创建 ASP.NET Core 应 用 程序 ， 它 们 
在 运行 时 会 有 不 同 ， 原 则 上 你 可 以 任意 选择 .NET 
Framework 或 .NET Core 选 项 ， 第 6 章 会 解释 它们 之 
间 的 区 别 。 但 是 请 注意 ， 本 书 使 用 了 .NET Core 选 
项 ， 所 以 请 你 尽量 也 选择 这 个 选项 以 确保 能 获得 和 
示例 代码 相同 的 结 





将 新 项 目的 名 称 设置 为 PartyInvites， 单 击 OK 
按钮 继续 ， 你 将 看 到 男 一 个 对 话 框 ， 要 求 你 为 项 目 
设置 初始 内 容 。 确 保 从 下 拉 六 蛙 中 选择 .NET Core 
和 ASP.NET Core 2.0 以 配置 初始 项 目 ， 如 图 2-3 所 
ZN o 


























图 2-3 ”进行 初始 项 目 配置 


这 里 有 几 个 模板 选项 ， 每 个 选项 都 会 创建 一 个 
具有 不 同 起 始 内 容 的 项 目 。 在 本 章 中 ， 选 择 Web 


Application (Model-View-Controller) 选项 ， 访 选项 
会 设置 MVC 应 用 程序 使 用 预定 义 的 内 容 局 动 开 发 。 


© 
va aA 
ve ee 


只 有 本 章 使 用 Web Application (Model-View- 
Controller) 项 目 模板 。 作 者 不 喜欢 使 用 预定 义 的 项 
目 模 板 ， 因 为 它们 或 励 开 及 人 员 将 一 些 重要 的 特性 

《如 里 份 验证 ) 视 为 黑 合 。 本 书 的 目标 是 让 你 了 解 
和 管理 MVC 应 用 程序 的 各 个 方面 ， 所 以 本 书 的 其 余 
部 分 均 使 用 了 空 模板 s IX OH RKTT IRR ATIN, 
所 以 使 用 Web Application (Model-View- 

Controller) 模板 非常 合适 。 


单 击 Change Authentication 按钮 ， 并 确保 选中 了 
No Authentication 单 选 按钮 ， 进 行 刁 份 验证 设置 ， 
如 图 2-4 所 示 。 这 个 项 目 不 需 要 任何 身份 验证 ， 但 
是 第 28 一 30 章 解释 了 如 何 对 ASP.NET 应 用 程序 进行 
LATE « 





© Windows Authentication 





Cancel 

















图 2-4 HEIT Ae i E 


单 击 OK 按钮 ， 然 后 关闭 Change Authentication 
对 话 框 。 确 保 没 有 勾 选 Host in the Cloud 复 选 枉 ， 然 
后 单 击 OK 按钮 创建 PartyInvites 项 目 。 


在 Visual Studio 中 创建 了 这 个 项 目 后 ， 你 将 看 
到 Solution Explorer 窗 格 中 显示 了 许多 文件 和 文件 


夹 ， 如 图 2-5 所 示 。 这 是 使 用 Web Application 模 板 创 
建 的 新 MVC 项 目的 默认 项 目 目录 ， 之 后 你 将 快速 了 
解 Visual Studio 创 建 的 每 个 文件 和 文件 夹 的 用 途 。 











图 2-5 ASP.NET Core MVC 项 目的 初始 文件 与 文件 夹 结构 


人 


fe ”未 


如 果 你 看 到 的 是 Pages 文 件 夹 而 不 是 





Controllers、Models 和 Views 文 件 夹 ， 那 么 说 明 你 选 
择 的 是 web Application 模 板 而 不 是 (相似 而 令 人 困 
XH) Web Application (Model-View-Controller) 
模板 。 你 必须 删除 你 创建 的 项 目 并 重新 开始 。 


你 可 以 通过 从 Debug 吏 单 中 选择 Start Debugging 
来 调试 运行 应 用 程序 〈 如 有 末 提 示 你 局 用 调试 ， 只 需 
要 单 击 OK 按钮 ) 。 当 你 这 样 做 时 ，Visual Studio® 
编译 应 用 程序 ， 使 用 名 为 IIS Express 的 应 用 程序 服 
务 来 运行 它 ， 并 打开 Web 浏 览 器 来 请 求 应 用 程序 的 
内 容 。 你 可 以 在 图 2-6 中 看 到 结果 。 


ASP.NET Core Windows Linux © 
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图 2-6 ”运行 示例 项 目 


当 Visual Studio 使 用 Web Application (Model- 
View-Controller) 模板 创建 项 目 时 ， 它 会 添加 一 些 
基本 的 代码 和 内 容 ， 这 就 是 你 在 运行 应 用 程序 时 所 
看 到 的 内 容 。 在 本 章 的 其 他 部 分 ， 将 蔡 换 这 些 内 
容 ， 以 创建 一 个 简单 的 MVC 应 用 程序 。 








当 你 完成 的 时 候 ， 请 通过 关闭 浏览 器 窗口 停止 
调试 ， 或 者 返回 Visual Studio， 并 从 Debug 荣 单 中 选 
择 Stop Debugging 以 停止 调试 。 


Visual Studio 通 过 打开 浏览 右 来 显示 项 目 。 选 
择 你 安装 的 任何 浏览 右 ， 单 击 IIS Express 工 具 栏 按 
钮 右边 的 箭头 ， 从 Web Browser 沈 单 的 选项 列表 中 
选择 要 使 用 的 浏览 磺 ， 如 图 2-7 所 示 。 


Test CodeMaid Analyze Window Help r 


en 
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Browse With. 


Internet Explorer 


Microsoft Edge 


图 2-7 ”选择 浏览 


本 书 的 所 有 截图 将 使 用 谷歌 Chrome 或 谷歌 
Chrome 金 丝 人 省 版 浏览 器 ， 但 你 也 可 以 使 用 任何 别 的 
Wags (Ai Microsoft Edge 和 最 新 版 本 的 Internet 
Explorer) 来 显示 书 中 的 示例 。 


2.3.1 ”添加 控制 需 


在 MVC 模 式 中 ， 传 入 的 请 求 由 控制 占 来 处 

> ASP.NET Core MVC 中 ， 控 制 器 是 一 个 C# 文 
(通常 从 Microsoft.AspNetCore.Mvc.Controller 类 
继承 ， 这 个 类 已 内 置 于 MVC 控 制 右 的 基本 类 中 ) 。 


Johr E E 
(action) 方法 ， 这 意味 看 你 可 以 通过 Web 基 于 菏 
种 URL 来 调用 执行 操作 方法 。MVC 约 定 通 常会 将 控 
制 器 放置 在 Controllers 文 件 夹 中 ， 当 创建 项 目 时 ， 
Visual Studio 会 目 动 创建 这 个 文件 来 。 


p 
提 示 


你 不 需要 一 定 遵循 这 个 或 大 多 数 其 他 的 MVC 
约定 ， 但 是 建议 你 仍然 遵守 一 一 因为 它 将 帮助 你 理 
解 本 书 中 的 示例 。 


Visual Studio 为 项 目 这 加 了 一 个 默认 的 控制 器 


类 ， 如 果 你 在 Solution we kJ Controllers X 
EK, MYGEN aA 
HomeController.cs. n ila 的 名 称 的 后 半 部 分 包 
含 Controller 这 个 单词 ， 这 意味 着 当 你 看 到 一 个 名 为 
HomeController.cs 的 文件 时 ， 就 知道 它 包含 一 个 名 
为 Home 的 控制 器 ，Home 是 MVC 应 用 中 使 用 的 默认 
控制 磺 。 单 击 Solution Explorer 中 的 
HomeController.cs 文 件 ， 通 过 Visual Studio 打 开 它 并 
进行 编辑 ， 你 将 看 到 代码 清单 2-1 所 示 的 C# 代 码 。 

















代码 清单 2-1 ”Controllers 文 件 夹 中 HomeController.cs 文 件 的 初 
始 内 容 





using System; 

using System.Collections.Generic; 
using System.Diagnostics; 

using System.Ling; 

using System. Threading. Tasks; 
using Microsoft.AspNetCore.Mvc; 
using PartyInvites.Models; 


namespace PartyInvites.Controllers { 
public class HomeController : Controller { 
public IActionResult Index() { 


return View(); 


} 


public IActionResult About() { 


ViewData["Message"]| = "Your application des 
cription page."; 


return View(); 


} 


public IActionResult Contact() { 
ViewData["Message"] = "Your contact page."; 


return View(); 


} 


public IActionResult Error() { 
return View(new ErrorViewModel { RequestId 
= Activity.Current?.Id 
?? HttpContext.TraceIdentifier }); 





将 HomeController.cs 中 的 代码 改 为 代码 清单 2-2 
所 示 的 样子 ， 只 保留 一 个 方法 并 且 删 除 其 他 的 方 
法 ， 更 改 结果 类 型 及 其 实现 ， 同 时 删除 没有 使 用 的 
命名 空间 所 在 的 using 语 句 。 


代码 清单 2-2 ”更改 Controller 文 件 夹 中 的 HomeController.cs 


using Microsoft.AspNetCore.Mvc; 


namespace PartyInvites.Controllers { 


public class HomeController : Controller { 


public string Index() { 
return “Hello World"; 





这 些 修改 没有 什么 特别 的 效果 ， 但 可 以 作为 很 
好 的 演示 。 这 里 更 改 了 名 为 Index 的 方法 ， 以 返回 字 
fF “Hello World”。 接 下 来 ， 从 Visual Studio 的 
Debug 菜 单 中 选择 Start Debugging 以 再 次 运行 这 个 项 
H o 


o 


fe 示 


如 果 之 前 的 应 用 程序 还 在 运行 ， 请 从 Debug 采 
单 中 选择 Restart， 或 者 选择 Stop Debugging 后 再 选 
择 Start Debugging， 开 始 这 个 新 的 应 用 程序 的 调 
io 


浏览 器 将 向 服务 器 发 出 一 个 HITP 请 求 。 默 认 
的 MVC 配 置 意味 看 这 个 请 求 将 使 用 Index 方 法 (这 
是 一 个 操作 方法 ) 来 处 理 ， 并 且 方 法 的 返回 结果 将 
被 发 送 回 浏览 器 ， 如 图 2-8 所 示 。 





Hello World 








图 2-8 ”操作 方法 的 输出 


二 
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WER, Visual Studio 己 将 浏览 器 定向 到 57628 
出 口 。 你 的 浏览 器 在 请 求 这 一 URL 时 ， 返 回 的 很 可 
能 是 一 个 不 同 的 病 口 号 ， 因 为 Visual Studio 在 创建 
项 目 时 会 分 配 一 个 随机 的 端口 号 。 如 果 伍 看 
Windows 任 务 栏 的 通知 区 域 ， 你 将 找到 IIS Express 
图 标 。 这 是 完整 的 1S 应 用 服务 占 的 一 个 简化 版 本 ， 
它 包 含 在 Visual Studio 中 ， 用 于 在 开发 过 程 中 发 布 
ASP.NET Core 的 内 容 和 服务 。 第 12 章 将 展示 如 何 将 
MVC 项 目 部 车 到 生产 环境 中 。 


zj- 





2.3.2 ”理解 路 由 


除了 模型 、 视 网 和 控制 锅 之 外 ，MVC 应 用 程 





序 还 使 用 了 ASP.NET 路 由 系统 ， 它 决定 了 如 何 把 
URL 了 映射 到 控制 问 和 action 上 。 路 由 是 用 来 决定 如 
何 处 理 请 求 规则 的 。 当 使 用 Visual Studio 创 建 MVC 
项 目 时 会 自动 添加 一 些 默 认 的 路 由 。 你 可 以 请 求 以 
下 任何 一 个 URL， 它 们 将 直接 指 同 HomeController 
的 Index 操 作 方 法 。 





o /。 
e /Home. 


e /Home/Index. 


此 ， 当 浏览 器 请 求 http://yoursite/ 或 
http://yoursite/Home 时 ， 它 将 从 HomeController 的 
Index 方 法 返回 和 输出。 你 可 以 通过 在 浏览 器 中 更 改 
URL 来 测试 一 下 效果 。 此 时 URL 会 古 
http://localhost:57628/〔 你 的 端口 号 部 分 可 能 与 此 处 
的 不 同 ) ， 如 果 你 将 /Home 或 /Home/Index 迁 加 到 
URL 并 按 下 Enter 键 ， 你 看 到 的 应 该 是 MVC 应 用 程 





序 输出 “Hello World”. 


这 是 关于 ASP.NET Core MVC 约 定 的 一 个 很 好 
的 示例 。 在 本 例 中 ， 我 们 约定 项 目 中 存在 一 个 名 为 
HomeControllerW) tila, FPA Pell as NIE A 
页 的 默认 控制 器 。 在 此 假设 Visual Studio 为 新 项 目 
创建 的 默认 路 由 配置 也 芝 循 这 个 约定 。 由 于 确实 苯 
人 循 了 这 个 约定 ， 因 此 这 里 自动 得 到 了 前 耐 列表 中 
URL 的 支持 。 如 果 没 有 亲 循 该 约定 ， 则 需要 修改 配 
置 ， 以 指向 此 处 创建 的 其 他 控制 絮 。 由 于 这 只 是 一 
个 简单 的 小 示例 ， 因 此 末 用 默认 配置 即 可 。 
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上 一 个 示例 的 输出 并 不 是 HIML， 而 只 是 字符 
串 “Hello World”。 要 为 浏览 器 请 求生 成 HTML 响 
应 ， 我 们 需要 视图 (view) ， 视 图 将 告诉 MVC 如 何 
为 浏览 器 生成 请 求 的 啊 应 。 








2.4.1 创建 并 演 染 视图 


我 们 需要 做 的 第 一 件 事 是 修改 Index 的 操作 方 
法 ， 如 代码 清单 2-3 所 示 。 更 改 部 分 以 粗 体 显示 ， 
这 是 本 书 齐 循 的 惯例 ， 以 使 示例 更 容易 理解 。 








代码 清单 2-3 ”修改 控制 器 以 在 HomeController.cs 中 呈现 视图 


using Microsoft.AspNetCore.Mvc; 


namespace PartyInvites.Controllers { 


public class HomeController : Controller { 


public ViewResult Index() { 
return View("MyView") ; 





当 从 一 个 操作 方法 返回 一 个 ViewResult 对 象 
时 ， 就 是 在 指示 MVC 去 泻 染 一 个 视图 。 可 通过 调用 
View 方 法 来 创建 ViewResult， 并 指定 要 使 用 的 视 
图 ， 比 如 MyView。 如 果 运 行 该 应 用 程序 ， 你 可 以 


看 到 MVC 会 试图 俘 找 所 要 使 用 的 视图 ， 参 见 图 2-9 
PIAS ES Fat ELS o 








图 2-9 ”错误 消息 


普 误 消 轧 对 你 是 很 有 帮助 的 ， 它 不 仅 解释 了 
MVC 无 法 找到 上 面 为 操作 方法 指定 的 视图 ， 而 且 显 
示 了 在 哪些 地 方 进行 了 查找 。 视 图 存储 在 Views 文 
件 夹 中 ， 并 将 其 组 织 为 子 文件 来。 例如 ， 与 Home 
控制 器 相关 联 的 视图 存储 在 一 个 名 为 Views/Home 的 
文件 夹 中 。 不 是 特定 于 单个 控制 器 的 视图 则 被 存储 
在 一 个 名 为 Views/Shared 的 文件 夹 中 。 当 使 用 Web 
Application (Model-View-Controller) 模板 时 ， 
Visual Studio 会 目 动 创建 Home 和 Shared 文 件 夹 ， 并 











放 入 一 些 占 位 用 的 视图 。 


下 面 开 始 创建 视图 ， 在 Solution Explorer 中 右 击 
Views > Home 文 件 严 并 从 弹出 的 染 单 中 选择 
Add > New Item. Visual Studio 将 为 你 提供 一 个 项 目 
模板 列表 。 使 用 左 侧 窗 格 选择 ASP.NET 的 类 别 ， 然 
后 在 中 央 窗 格 中 选择 MVC View Page 选 项 ， 创 建 视 
图 ， 如 图 2-10 所 示 。 不 要 使 用 RazorPage 模 板 ， 它 与 
MVC 框 染 无 关 。 


G 
提 示 


你 将 在 Views 文 件 夹 中 看 到 一 些 已 经 存在 的 文 
件 ， 这 些 文 件 被 Visual Studio 添 加 到 项 目 中 以 提供 
一 些 初 始 内 容 ， 其 中 一 些 你 已 经 在 图 2-7 中 看 到 。 





你 可 以 忽略 这 些 文件 。 


在 Views/Home 文 件 夹 中 创建 一 个 名 为 
MyView.cshtml 的 视图 文件 。Visual Studio 将 自动 创 
建 Views/ Home/MyView.cshtml 文 件 并 打开 它 ， 进 入 
编辑 页 面 。 视 图 文件 的 初始 内 容 只 是 一 些 注释 和 占 
位 从 。 请 将 它们 蔡 换 为 代码 清单 2-4 所 示 的 内 容 。 














Cancel 





图 2-10 ”创建 视图 





代码 清单 2-4 用 如 下 代码 符 换 Views/Home 文 件 夹 下 
MyView.cshtml 文 件 的 内 容 


@{ 
Layout = null; 
} 


<!DOCTYPE html> 


<html> 
<head> 

<meta name="viewport" content="width=device-width" 
/> 

<title>Index</title> 
</head> 
<body> 

<div> 

Hello World (from the view) 

</div> 
</body> 
</html> 
The new contents of the view file are mostly HTML. The 
exception is the part that looks like this: 


at 


Layout = null; 





} 


fe ” 示 


初学 者 很 容易 在 错误 的 文件 夹 中 创建 视图 文 
件 。 如 果 你 没有 在 Views/Home 文 件 夹 中 创建 一 个 名 
为 MyView.cshtml 的 文件 ， 请 删除 你 创建 的 文件 并 
FRR 


这 是 一 个 通过 Razor 视 图 引擎 进行 解释 的 表达 
式 Cexpression) ， 它 处 理 视 图 的 内 容 并 生成 发 送 到 
浏览 器 的 HIML。 这 是 一 个 简单 的 Razor 表 达 式 ， 它 
告诉 Razor 选 择 不 使 用 布局 ， 它 就 像 HIML 模 板 ， 将 
被 发 送 到 浏览 器 〈 将 在 第 5 草 中 详 述 ) 。 现 在 我 们 
先 和 暂时 不 讨论 Razor 的 问题 ， 稍 后 回 过 头 来 再 讨 
论 。 我 们 现在 想 要 查看 视图 的 创建 效果 ， 请 从 
Debug 沫 单 中 选择 Start Debugging 以 运行 应 用 程序 。 
你 应 该 会 看 到 图 2-11 所 示 的 结 





Hello World (from the view) 


图 2-11 WALA AGAR 





ee 操作 方法 时 ， 返 回 的 是 一 
个 字符 串 值 。 这 意味 着 MVC 除 了 将 字符 串 值 传递 给 
浏览 喜之 外 什么 都 没 做 。 现 在 ，Index 方 法 返回 了 一 
个 ViewResult，MVC 演 染 了 一 个 视图 并 返回 它 所 生 
成 的 HTML。 因 为 已 经 告诉 MVC 应 该 使 用 哪个 视 
图 ， 所 以 MVC 会 使 用 命名 约定 来 日 动 找到 它 。 我 们 
约定 视图 具有 操作 方法 的 名 称 ， 并 且 包 含 在 一 个 以 
控制 器 命名 的 文件 夹 /Views/Home/MyView.cshtml 
中 。 








RS + n FA POWA 站 ， 还 可 _— 
作 方 法 返回 其 他 结果 。 例 如 ， 如 果 返 
RedirectResult， 浏 览 器 将 被 重 定 加 到 另 一 个 URL 。 





如 果 返 回 一 个 HttpUnauthorizedResult， 则 会 强制 用 

户 登 录 。 这 些 对 象 统称 为 操作 结 有 末 。Action Result 

系统 允许 你 封装 和 重用 操作 中 的 音 见 啊 应 。 第 17 章 
将 对 其 做 更 多 的 介绍 并 演示 一 些 不 同 的 方法 。 





2.4.2 ”添加 动态 输出 


Web 应 用 程序 平台 的 核心 要 点 就 是 构造 和 显示 
动态 输出 。 在 MVC 中 ， 控 制 占 的 任务 是 构造 一 些 数 
拓 并 将 其 传递 给 视图 ， 视 图 再 人 负 员 将 其 渔 染 成 
HTML. 








从 控制 器 传递 数据 到 视图 的 一 种 方法 是 使 用 
ViewBag 对 象 ， 它 是 控制 器 基本 类 里 的 一 个 成 员 。 
ViewBag 是 一 个 动态 对 象 ， 可 以 为 它 分 配 任意 属 
性 ， 使 这 些 值 在 随后 泻 染 的 任何 视图 中 都 保持 可 
用 。 代 人 码 清 单 2-5 演 示 了 在 HomeController.cs 文 件 中 
如 何 通 过 这 种 方式 传递 一 些 简 单 的 动态 数据 。 








代码 清单 2-5 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 传递 动态 数据 


using System; 
using Microsoft.AspNetCore.Mvc; 


namespace PartyInvites.Controllers { 


public class HomeController : Controller { 


public ViewResult Index() { 
int hour = DateTime.Now.Hour; 
ViewBag.Greeting = hour < 12 ? "Good Mornin 
" : "Good Afternoon"; 
return View("MyView") ; 








为 ViewBag.Greeting 属 性 赋值 ， 便 是 为 视图 提 
供 数 据 。ViewBag.Greeting 属 性 直到 被 赋值 时 才 会 
形成 ， 你 不 需要 提前 定义 类 ， 这 使 得 你 可 以 更 加 目 
如 方便 地 将 数据 从 控制 器 传递 给 视图 。 在 视图 中 再 
次 检索 ViewBag. Greeting 属 性 可 以 获取 其 数据 值 ， 
如 代码 清单 2-6 所 示 ， 它 显示 了 对 MyView.cshtml 文 
件 所 做 的 相应 更 改 。 











代码 清单 2-6 ”在 Views/Home 文 件 夹 下 的 MyView.cshtml 文 件 中 
对 ViewBag.Greeting 的 数据 值 进 行 检索 


@{ 
} 


<!DOCTYPE html> 


Layout = null; 


<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 
<title>Index</title> 
</head> 
<body> 
<div> 
@ViewBag.Greeting World (from the view) 
</div> 
</body> 
</html> 





RAI TEREI 2-6 Fs DUE Ze — “PS Razorz#es& 
式 ， 当 MVC 使 用 视图 生成 啊 应 时 ， 将 对 其 进行 求 
值 。 当 在 控制 喜 的 Index 方 法 中 调用 View 方 法 时 ， 
MVC 定 位 了 MyView.cshtml 视 图 文件 并 要 求 Razor 视 
图 引擎 解析 文件 的 内 容 。Razor 会 寻找 类 似 于 本 例 








中 添加 的 这 种 表达 式 并 处 理 它们 。 在 本 例 中 ， 只 要 
处 理 这 个 Razor 表 达 式 ， 束 会 在 视图 中 插入 你 在 操 
作 方 法 里 赋 给 ViewBag.Greeting 的 值 。 


属性 名 ViewBag.Greeting 只 是 一 个 普通 的 代 
写 ， 你 可 以 用 任何 属性 名 蔡 换 它 而 不 会 改变 其 工作 
方式 ， 只 需要 保证 在 控制 右 中 使 用 的 名 称 与 在 视图 
中 使 用 的 名 称 匹 配 即 可 。 你 可 以 将 值 分 配给 多 个 属 
性 来 实现 多 个 数据 值 从 控制 器 到 视图 的 传递 。 请 通 
过 局 动 项 目 来 看 看 这 些 更 改 的 效果 ， 来 自 MVC 的 动 
态 啊 应 如 图 2-12 所 示 。 











|- Index 


G | © locathost:57628 


Good Afternoon World (from the view) 





图 2-12 ”来自 MVC 的 动态 响应 


2.5 ”创建 一 个 简单 的 数据 录入 程序 





本 章 剩 下 的 部 分 将 通过 构建 一 个 简单 的 数据 录 
入 程序 探索 MVC 更 多 的 基本 特性 。 本 市 将 加 快 进 
度 以 演示 MVC 的 实际 操作 ， 因 此 将 跳 过 一 些 天 于 萌 
后 工作 原理 的 解释 。 但 别 担心 ， 后 面 的 章 市 将 深入 


讨论 这 些 主题 。 





2.5.1 设置 场景 


假设 有 个 朋友 决定 举行 一 场 新 年 夜 派 对 ， 她 邀 
请 你 为 此 创建 一 个 web 应 用 程序 ， 以 便 受 邀 人 能 人 够 
进行 电子 回复 。 要 求 如 下 。 


WANA RRA ED 

可 用 于 回复 的 表单 。 

实现 电子 回复 表单 (RSVP) 的 验证 ， 将 显示 感 
谢 页 面 。 

总 结 页 面 ， 显 示 谁 会 来 参加 聚会 














下 面 将 介绍 如 何 修改 完善 在 本 章 开 始 时 创建 的 


MVC 项 目 ， 并 添加 上 述 几 个 要 求 。 通 过 前 面 介 绍 的 
内 容 可 以 实现 第 一 个 要 求 ， 并 添加 一 些 HIML 到 现 
有 视图 中 ， 以 提供 有 关 聚 会 的 详细 信息 。 代 人 码 清 单 
2-7 显 示 了 对 Views/Home/MyView.cshtml 文 件 所 做 
的 修改 。 





代码 清单 2-7 在 MyView.cshtml 文 件 中 显示 聚会 的 详细 信息 





@{ 
} 


<!DOCTYPE html> 


Layout = null; 


<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Index</title> 
</head> 
<body> 
<div> 
@ViewBag.Greeting World (from the view) 
<p>We're going to have an exciting party.<br /> 
(To do: sell it better. Add pictures or somethin 
g-) 
</p> 
</div> 


</body> 


</html> 


ZT VA FE, WM Debugsé HF ve eStart 
Debugging， 你 将 看 到 聚会 的 详细 信息 〈 评 细 信 息 
用 一 个 占 位 符 表 示 ， 你 只 要 懂得 操作 方式 就 好 )， 
如 图 2-13 所 示 。 


|- Index x 


CS | © locathost:57628 j| }; 





Good Afternoon World (from the view) 


We're going to have an exciting party. 
(To do: sell it better. Add pictures or something.) 











图 2-13 ”添加 到 视图 中 的 HTML 表 示 聚 会 的 详细 信息 


2.5.2 ”设计 数据 模型 





在 MVC 中 ，M 代 表 模 型 ， 它 是 应 用 程序 中 节 重 
要 的 部 分 。 模 型 是 现实 世界 中 实际 对 象 、 过 程 和 规 
则 的 表示 。 模 型 通常 称 为 领域 模型 (Domain 
Model) ， 包 含 应 用 程序 域 中 要 建立 的 C# 领 域 对 象 
(Domain Object) 和 操作 它们 的 方法 。 视 网 和 控制 





船 以 一 致 的 方 却 加 客户 端 暴露 领域 对 象 ， 而 设计 民 
好 的 MVC 应 用 程序 往往 从 设计 民 好 的 模型 开始 ， 这 
征 作 为 控制 左 和 视图 添加 的 关键 点 。 











这 里 只 是 朋友 间 使 用 的 一 个 简单 程序 ， 并 不 需 
要 复杂 的 PartyInvites 项 目 模型 。 接 下 来 ， 将 会 创建 
一 个 名 为 GuestResponse 的 领域 类 ， 它 负责 存储 、 验 
证 和 确认 电子 回复 。 


MVC 约 定 将 组 成 模型 的 类 放置 在 名 为 Models 
的 文件 夹 中 。 要 创建 Models 文 件 夹 ， 可 右 击 
PartyInvites 项 目 〈 项 目 中 已 包含 Controllers 和 Views 
文件 夹 ) ， 从 弹出 沫 单 中 选择 Add — New Folder, 
并 设置 文件 夹 的 名 称 为 Models。 





为 了 创建 类 文件 ， 在 Solution Explorer 中 右 击 
Models 文 件 夹 并 从 弹出 染 单 中 选择 Add- Class。 将 
新 类 的 名 称 设置 为 GuestResponse.cs 并 单 击 Add 按 


钮 。 编 辑 这 个 新 的 英文 件 的 内 容 ， 如 代码 清单 2-8 
FITAR o 


代码 清单 2-8 ”在 Models 文 件 夹 下 的 GuestResponse.cs 文 件 中 定 
义 GuestResponse 领 域 类 


namespace PartyInvites.Models { 
public class GuestResponse { 


public string Name { get; set; } 


public string Email { get; set; } 
public string Phone { get; set; } 
public bool? WillAttend { get; set; } 





人 


提 ZN 


你 可 能 已 经 注意 到 ，WillAttend 属 性 是 一 个 可 


以 为 空 的 bool 值 ， 这 意味 着 可 以 是 true、false 或 
null。2.5.8 节 会 解释 这 一 点 。 


2.5.3 ”创建 第 二 个 操作 和 强 类 型 视图 


这 个 应 用 程序 的 目标 之 一 是 包含 一 个 电子 回复 
表单 ， 因 此 需要 定义 一 个 可 以 接收 请 求 的 操作 方 
法 。 单 个 控制 卉 类 可 以 定义 多 个 操作 方法 ， 而 约定 
征 将 相关 的 操作 集中 在 同一 个 控制 锅 中 。 代 码 清单 
2-9 显 示 了 如 何 同 主 控制 右 中 添加 一 个 新 的 操作 方 
Wee 








代码 清单 2-9 在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 


中 添加 一 个 操作 方法 





using System; 
using Microsoft.AspNetCore.Mvc; 


namespace PartyInvites.Controllers { 


public class HomeController : Controller { 


public ViewResult Index() { 
int hour = DateTime.Now.Hour; 
ViewBag.Greeting = hour < 12 ? "Good Mornin 
g" : "Good Afternoon" ; 
return View("MyView") ; 


} 


public ViewResult RsvpForm() { 
return View(); 











电子 回复 表单 的 操作 方法 是 一 种 不 珊 参 数 调用 
的 视图 方法 ， 它 告诉 MVC 演 染 与 操作 方法 关联 的 默 
认 视 图 ， 默 认 视 图 与 操作 方法 的 名 称 需 要 相同 ， 在 
本 例 中 为 RsvpForm.cshtml。 








右 击 Views/Home 文 件 夹 并 从 弹出 末 单 选择 
Add > New Item。 从 ASP.NET 类 别 中 选择 MVC 
View Page 模 板 ， 将 新 文件 命名 为 
RsvpForm.cshtml。 然 后 单 击 Add 投 钮 创建 文件 。 更 
改 文 件 的 内 容 ， 如 代码 清单 2-10 所 示 。 


代码 清单 2-10 ”更改 Views/Home 文 件 夹 中 RsvpForm.cshtml 文 
件 的 内 容 


@model PartyInvites.Models.GuestResponse 


@{ 
} 


<!DOCTYPE html> 


Layout = null; 


<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>RsvpForm</title> 
</head> 
<body> 
<div> 
This is the RsvpForm.cshtml View 
</div> 
</body> 
</html> 








虽然 内 容 主要 是 HTML 代码 ， 但 添加 了 @model 
Razor 表 达 式 ， 用 于 创建 强 类 型 视图 。 强 类 型 视图 
用 于 泻 染 特定 类 型 的 模型 ， 如 果 指 定 要 处 理 的 类 型 


《比如 PartyInvites.Models 中 的 GuestResponse 类 ) ， 


MVC 可 以 创建 一 些 便于 使 用 这 种 类 型 的 方法 
(MVC 本 里 提供 了 一 些 便 捷 的 方法 ， 可 以 在 视图 中 
方便 地 使 用 这 种 类 型 ) 。 


要 测试 新 的 操作 方法 及 其 视图 ， 可 以 从 Debug 
菜单 中 选择 Start Debugging 来 启动 应 用 程序 ， 并 使 
用 浏览 器 导航 到 /Home/RsvpForm 这 个 URL。 








MVC 将 使 用 前 面 描述 的 命名 约定 来 将 请 求 引 
导 到 由 主 控制 器 定义 的 RsvpForm 这 个 操作 方法 。 
RsvpForm 方 法 会 告诉 MVC 泻 染 默 认 视 图 ， 默 认 视 
图 使 用 男 一 个 应 用 程序 命名 约定 来 演 梁 Views/ 
Home 文 件 严 中 的 RsvpForm.cshtml 文 件 。 图 2-14 最 
AN J ZAR» 





| RevpForm 


€ C | © localhost:57628/Home/RsvpForm 


This is the RsvpForm.cshtml View 








42-14 ” 演 染 第 二 个 视图 的 结果 


2.5.4 ”链接 操作 方法 


如 果 从 MyView 视 图 中 创建 一 个 链接 ， 这 样 访 
客 束 可 以 看 到 RsvpForm 视 图 ， 而 不 必 知 道 针 对 特定 
操作 方法 的 URL， 其 体操 作 如 代码 清单 2-11 所 示 。 


代码 清单 2-11 在 MyView.cshtml 文 件 中 同 RSVP Form 视 图 添 
加 一 个 链接 





@{ 
} 


<!DOCTYPE html> 


Layout = null; 


<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Index</title> 
</head> 
<body> 
<div> 
@ViewBag.Greeting World (from the view) 
<p>We're going to have an exciting party.<br /> 
(To do: sell it better. Add pictures or somethi 
ng.) 


</p> 
<a asp-action="RsvpForm">RSVP Now</a> 


</div> 
</body> 
</html> 


代码 清单 2-11 添 加 了 一 个 拥有 asp-action 属 性 的 
元 素 ，asp-action 属 性 是 标签 助手 ， 它 会 在 泻 染 视图 
时 执行 Razor 指 令 。asp-action 属 性 是 将 href 属 性 添加 
到 包含 指向 操作 方法 的 URL 的 a 元 素 中 的 指令 。 第 
24 一 26 草 将 详 述 标签 A asp-action 属 
性 是 最 简单 的 一 种 标签 助手 ， 它 告诉 Razor 插 入 一 
个 URL， ER 同一 
控制 器 定义 。 你 可 以 通过 局 动 项 目 看 到 标签 助手 创 
建 的 链接 ， 如 图 2-15 所 示 。 




















图 2-15 ”链接 两 个 操作 方法 


局 动 应 用 程序 ， 在 浏览 强 中 移动 光标 到 RSVP 


Now 链 接 上， 你 将 看 到 链接 指 问 以 下 URL MY 
Visual Studio 给 你 的 项 目 分 配 不 同 的 端口 号 〉: 


http://localhost:57628/Home/RsvpForm 


这 里 有 一 个 重要 的 原则 ， 你 应 该 使 用 MVC 提 
供 的 特性 〈feature) 来 生成 URL， 而 不 是 将 它们 硬 
编码 到 你 的 视图 中 。 妆 使 用 标签 助 手 为 a 元 系 创 建 
href 属 性 时 ， 它 会 检查 应 用 程序 的 配置 以 确定 
URL。 这 让 应 用 程序 的 配置 可 以 支持 不 同 的 URL 格 
式 ， 而 不 需要 再 去 更 新 任何 视图 。 第 15 间 将 解释 原 
Ps 








2.5.5 ”建立 表单 


既然 已 经 创建 了 强 类 型 视图 ， 并 且 可 以 从 
Index 视 图 中 访问 它 ， 接 下 来 就 构建 
RsvpForm.cshtml 文 件 的 内 容 并 转换 成 用 于 编辑 
GuestResponse 对 象 的 HTML 表 单 ， 如 代码 清单 2-12 


所 示 。 


代码 清单 2-12” 在 Views/Home 文 件 夹 下 的 RsvpForm.cshtml 文 
件 中 创建 一 个 表单 视图 





@model PartyInvites.Models.GuestResponse 


@{ 
Layout = null; 
} 


<!DOCTYPE html> 


<html> 
<head> 

<meta name="viewport" content="width=device-width" 
/> 

<title>RsvpForm</title> 


</head> 
<body> 
<form asp-action="RsvpForm" method="post"> 
<p> 
<label asp-for="Name">Your name:</label> 
<input asp-for="Name" /> 
</p> 
<p> 
<label asp-for="Email">Your email:</label> 
<input asp-for="Email" /> 
</p> 
<p> 


<label asp-for="Phone">Your phone:</label> 
<input asp-for="Phone" /></p> 


<p> 
<label>Will you attend?</label> 
<select asp-for="WillAttend"> 
<option value="">Choose an option</opti 
on> 
<option value="true">Yes, I'll be there 
</option> 
<option value="false">No, I can't come< 
/option> 


</select> 
</p> 
<button type="sSubmit">Submit RSVP</button> 
</form> 
</body> 
</html> 





这 里 为 GuestResponse 模 型 类 的 每 个 属性 都 定义 
了 一 个 label 元 系 和 一 个 input 元 素 〈 或 为 WillAttend 
属性 定义 了 一 个 select 元 素 ) 。 标 签 助手 的 另 一 个 功 
能 就 是 把 每 个 元 素 都 使 用 asp-for 属 性 与 模型 属性 关 
联 起 来 。 标 签 助手 属性 可 通过 配置 将 元 素 绑 定 到 模 
型 对 象 。 下 面 是 使 用 标签 助手 生成 HTML 并 将 其 发 
送 到 浏览 名 的 示例 : 

















<p> 
<label for="Name">Your name:</label> 
<input type="text" id="Name" name="Name" value=""> 


</p> 


这 里 使 用 label 元 素 的 asp-for 属 性 设置 了 for 属 性 
的 值 ， 使 用 input 元 素 的 asp-for 属 性 设置 了 id 和 mname 
元 素 的 值 。 这 在 目前 看 起 来 并 不 是 特别 有 用 ， 但 是 
你 以 后 会 发 现 将 元 素 与 模型 属性 相关 联 会 提供 额外 
的 优势 。 














更 直接 的 是 应 用 于 form 元 素 的 asp-action 属 性 ， 
通过 应 用 程序 的 URL 路 由 配置 将 action 属 性 设置 
为 一 个 URL， 该 URL 将 针对 特定 的 操作 方法 ， 如 下 
所 示 : 








<form method="post" action="/Home/RsvpForm" > 





与 应 用 于 元 素 的 helper 属 性 一 样 ， 这 种 方法 的 
好 处 是 可 以 更 改 应 用 程序 使 用 的 系统 URL， 而 由 标 
签 助 手 生 成 的 内 容 也 将 日 适应 这 些 更 改 。 








你 可 以 通过 运行 应 用 程序 并 单 击 RSVP Now 链 





接 〈 见 图 2-15) 来 查看 表单 ， 如 图 2-16 所 示 。 








Submit RSVP | 








图 2-16 ”查看 表单 


2.5.6 ”接收 表单 数据 


当 把 表单 发 布 到 服务 器 时 ， 我 们 还 没有 告诉 
MVC 我 们 要 做 什么 。 现 在 单 击 Submit RSVP 按 钮 只 
会 清除 我 们 已 输入 表单 的 所 有 值 。 这 是 因为 在 
Home 控 制 器 中 表单 仪 仪 返回 了 同一 个 RsvpForm 的 
操作 方法 ， 它 只 告诉 MVC 再 次 泻 染 视图 (所 以 表单 
内 容 没 有 保存 而 被 刷新 挥 〉。 








为 了 接收 和 人 处理 近 交 的 表单 数据 ， 这 里 将 使 用 


一 个 核心 的 控制 右 特 性 。 这 里 将 添加 第 二 个 
RsvpForm 操作 方法 来 创建 以 下 内 容 : 


e li] YHTTP GET 请 求 的 方法 。GET 请 求 是 当 用 户 
每 次 单 击 链接 时 浏览 器 发 出 的 请 求 。 在 该 例 
中 ， 这 个 操作 方法 将 负责 在 第 一 次 访 
问 /Home/RsvpForm 时 显示 初始 的 空白 表单 。 

。 啊 应 HTTP POST 请 求 的 方法 。 默 认 情 况 下 ， 使 
用 Html.BeginForm() 泻 染 的 表单 在 被 浏览 器 提 交 
时 ， 将 发 出 POST 请 求 。 在 该 例 中 ， 这 个 操作 方 
法 将 负 贡 接收 提交 的 数据 并 决定 如 何 处 理 它 
AT 




















在 独立 的 C# 方 法 中 处 理 GET 和 POST 请 求 有 助 
于 保持 控制 器 代码 整洁 ， 因 为 这 两 种 方法 有 不 同 的 
职责 。 虽 然 这 两 个 操作 方法 都 调用 同一 个 URL， 但 
是 MVC 会 基于 使 用 的 是 GET 还 是 POST 请 求 来 采取 
不 同 的 方法 处 理 请 求 。 代 码 清单 2-13 显 示 了 对 
HomeController 类 所 做 的 更 改 。 


代码 清单 2-13 ”在 HomeController.cs 文 件 中 添加 一 个 操作 方法 
来 支持 POST 请 求 


using System; 
using Microsoft.AspNetCore.Mvc; 
using PartyInvites.Models; 


namespace PartyInvites.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 
int hour = DateTime.Now.Hour; 
ViewBag.Greeting = hour < 12 ? "Good Mornin 
"Good Afternoon"; 
return View("MyView") ; 


} 


[HttpGet] 
public ViewResult RsvpForm() { 
return View(); 


} 


[HttpPost] 
public ViewResult RsvpForm(GuestResponse guestR 
esponse) { 
// TODO: store response from guest 
return View(); 





X 


这 里 已 经 将 HttpGet 特 性 添加 到 现 有 的 





RsvpForm 操 作 方 法 中 ，MVC 知 道 该 方法 只 可 用 于 
GET 请 求 。 然 后 ， 添 加 了 一 个 重 载 版 本 的 RsvpForm 
操作 方法 ， 该 方法 接收 一 个 GuestResponse 对 象 。 如 
果 将 HttpPost 特 性 应 用 于 此 方法 ，MVC 会 使 用 这 个 
方法 处 理 POST 请 求 。 随 后 几 节 将 解释 这 些 附加 的 
操作 是 如 何 工 作 的 。 这 里 还 导入 了 
PartyInvites.Models 命 名 空间 ， 这 样 束 可 以 引用 


GuestResponse 模 型 类 型 ， 而 不 需要 类 名 。 
1， 使 用 模型 绑 定 


第 一 个 重 载 的 RsvpForm 操 作 方 法 与 前 面 的 
RsvpForm.cshtml 文 件 泻 染 的 是 同一 个 视图 ， 参 见 图 
2-16 所 示 的 表单 。 第 二 个 重 载 的 参数 变 得 较 有 趣 ， 
考虑 到 操作 方法 是 在 响应 HTTP POST 请 求 时 被 调用 
的 ， 而 GuestResponse 古 一 个 C# 类 ， 二 者 是 如 何 连 
接 的 呢 ? 











答案 是 模型 绑 定 (Model Binding) ， 这 是 一 个 
很 有 用 的 MVC 特 性 ， 通 过 解析 传 入 的 数据 ， 并 使 用 
HTTP 请 求 中 的 键 / 值 对 填充 领域 模型 类 型 的 属性 。 


模型 绑 定 是 一 种 强大 且 可 定制 的 特性 ， 它 消除 
了 直接 处 理 HITP 请 求 刘 来 的 烦 开 工 作 ， 让 你 直接 
操作 C# 对 象 ， 而 不 是 处 理 浏览 器 发 送 的 单个 数据 
值 。GuestResponse 对 象 将 作为 参数 传递 给 操作 方 
法 ， 该 对 象 会 自动 填充 来 自 表 单字 段 的 数据 。 第 26 
章 将 详细 介绍 模型 绑 定 的 细节 ， 包 括 如 何 定制 它 。 








这 个 应 用 程序 的 最 后 一 个 目标 是 提供 总 结 页 
面 ， 其 中 包含 参加 聚会 的 人 员 信 息 ， 这 意味 着 需要 
跟 躁 收 到 的 啊 应 。 通 过 创建 对 象 的 内 存 集合 来 实现 
这 一 点 。 昌 然 在 实际 应 用 中 这 可 能 不 太 好 用 ， 因 为 
当 应 用 程序 停止 或 重新 局 动 时 ， 啊 应 数据 将 丢失 ， 
但 是 这 种 方法 将 允许 开发 人 员 你 持 对 MVC 的 持续 关 
注 ， 并 创建 一 个 很 容易 被 重 置 为 初始 状态 的 应 用 程 




















2 


fe 示 


第 8 革 将 演示 MVC 的 持久 存储 和 数据 访问 ， 这 
是 更 贴 合 实 际 使 用 的 一 个 示例 。 





添加 一 个 文件 到 项 目的 Models 文 件 夹 并 右 击 ， 
选择 Add -Class， 将 文件 命名 为 Repository.cs 并 使 
用 它 来 定义 类 ， 如 代码 清单 2-14 所 示 。 


代码 清单 2-14 Models 文 件 夹 下 的 Repository.cs 文 件 的 内 容 


using System.Collections.Generic; 
namespace PartyInvites.Models { 


public static class Repository { 
private static List<GuestResponse> responses = 
new List<GuestResponse>() ; 


public static IEnumerable<GuestResponse> Respon 
ses { 


get { 
return responses; 
} 


} 


public static void AddResponse(GuestResponse re 
sponse) { 


responses.Add(response) ; 








Repository 类 及 其 成 员 是 静态 的 ， 这 将 使 开发 
员 能 够 轻松 地 从 应 用 程序 的 不 同位 置 存 储 和 检索 
数据 。MVC 提 供 了 一 种 更 复杂 的 方法 来 定义 通用 的 
功能 ， 称 为 依赖 注入 Cdependency injection) ， 这 
将 在 第 18 草 中 详 述 ， 但 静态 类 是 一 种 很 好 的 方法 ， 
可 以 用 于 简单 的 程序 。 








2. 存储 啊 应 





既然 可 以 存储 数据 了 ， 接 下 来 就 更 新 接收 
HTTP POST 请 求 的 操作 方法 ， 如 代码 清单 2-15 所 
示 。 





代码 清单 2-15 “更 新 HomeController.cs 文 件 中 的 操作 方法 





using System; 
using Microsoft.AspNetCore.Mvc; 
using PartyInvites.Models; 


namespace PartyInvites.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 
int hour = DateTime.Now.Hour; 
ViewBag.Greeting = hour < 12 ? "Good Mornin 
g" : "Good Afternoon" ; 
return View("MyView") ; 


} 


[HttpGet] 
public ViewResult RsvpForm() { 
return View(); 


} 


[HttpPost] 
public ViewResult RsvpForm(GuestResponse guestR 
esponse) { 
Repository .AddResponse(guestResponse); 
return View( "Thanks", guestResponse); 


所 要 做 的 就 是 处 理发 送 到 请 求 中 的 表单 数据 ， 
比如 处 理 传 递 给 操作 方法 的 GuestResponse 对 象 ， 将 
其 作为 参数 传递 给 Repository.AddResponse 方 法 ， 以 
存储 啊 应 。 


为 什么 模型 绑 定 不 像 Web 表 单 绑 定 ? 


第 1 章 解 释 了 传统 ASP.NET Web Forms 的 一 个 
缺点 是 将 HITP 和 HTML 的 细节 对 开发 人 员 隐 藏 。 
你 可 能 想 知 道 ， 在 代码 清单 2-15 中 用 于 从 HTTP 
POST 请 求 创建 GuestResponse 对 象 的 MVC 模 型 绑 定 
是 人寿 也 在 做 同样 的 事情 。 


答案 为 不 是 。 模 型 绑 定 去 除了 烦琐 和 易 导 致 错 


误 的 任务 ， 使 开发 人 员 不 需要 检查 HTTP 请 求 和 所 
取 每 一 个 数值 ， 但 (这 是 最 重要 的 部 分 ) 如 果 开 发 
人 员 想 手动 处 理 一 个 请 求 ， 仍 然 可 以 使 用 模型 绑 
定 ， 因 为 MVC 提 供 了 对 所 有 请 求 数据 的 轻松 访问 方 
式 。MVC 没 有 对 开发 人 员 隐 藏 任何 东西 《所 有 数据 
和 操作 都 是 可 见 的 ) ， 而 且 其 中 还 有 许多 特性 可 以 
更 简易 地 使 用 HTTP 和 HTML。 当 然 ， 为 了 使 用 这 


些 特性 ， 你 需要 手动 选择 。 


这 似乎 是 一 个 细微 的 差别 ， 但 是 随 着 你 对 
MVC 的 了 解 ， 你 将 感受 到 这 种 开发 体验 与 传统 
ASP.NET Web Forms 是 完全 不 同 的 ， 并 且 你 总 是 可 
以 知道 如 何 处 理应 用 程序 接收 的 请 求 。 


在 RsvpForm 操 作 方 法 中 调用 View 方 法 ， 使 得 
MVC 演 染 一 个 名 为 Thanks 的 视图 ， 并 将 


GuestResponse 对 象 传递 给 视图 。 要 创建 视图 ， 可 在 
Solution Explorer 中 右 击 View/Home 文 件 夹 并 从 弹出 
菜单 中 选择 Add > New Item。 在 ASP.NET 类 别 中 选 
择 MVC View Page 模 板 ， 命 名 为 Thanks.cshtml， 单 
击 Add 按 钮 。Visual Studio 将 创建 
Views/Home/Thanks.cshtml 文 件 并 打开 它 进 行 编 

辑 。 更 改 访 文 件 的 内 容 ， 如 代码 清单 2-16 所 示 。 





代码 清单 2-16 ”Views 人 Home 文 件 夹 下 的 Thanks.cshtml 文 件 的 内 


IP 


谷 





@model PartyInvites.Models.GuestResponse 


@{ 
} 


<!DOCTYPE html> 


Layout = null; 


<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Thanks</title> 
</head> 
<body> 


<p> 
<hi>Thank you, @Model.Name!</h1> 
@if (Model.WillAttend == true) { 
@:It's great that you're coming. The drinks 
are already in the fridge! 
} else { 
@:Sorry to hear that you can't make it, but 
thanks for letting us know. 
} 
</p> 
<p>Click <a asp-action="ListResponses">here</a> to 
see who is coming.</p> 
</body> 
</html> 





Thanks.cshtml 视 图 文件 基于 在 RsvpForm 操 作 方 
法 中 传递 给 View 方 法 的 GuestResponse 属 性 的 值 并 
使 用 Razor 来 显示 内 容 。Razor 的 @model 表 达 式 指定 
了 强 类 型 视图 的 领域 模型 类 型 。 


使 用 Model.PropertyName 来 访问 领域 对 象 中 的 
属性 值 。 举 一 个 示例 ， 要 获取 Name 属 性 的 值 ， 可 
调用 Model.Name。 不 用 担心 Razor 的 语法 是 没有 意 
义 的 一 一 第 5 草 将 更 详细 地 解释 它 。 





现在 Thanks 视 图 已 经 创建 了 ， 这 是 一 个 使 用 
MVC 处 理 表 单 的 基本 示例 。 在 Visual Studio 中 ， 从 
Debug 沫 单 中 选择 Start Debugging 以 启动 应 用 程序 ， 
单 击 RSVP Now 链 接 ， 回 表单 添加 一 些 数 据 ， 然 后 
单 击 Submit RSVP 按 钮 。 你 将 看 到 图 2-17 所 示 的 结 
果 〈 当 名 字 不 是 Joe 或 者 你 不 能 参加 聚会 时 ， 会 显 
示 不 同 的 感谢 信息 ) 。 






Form 


anks 
RsvpForm = 
< C | @ localhost:575628/Home/RsvpForm x| : 


Thank you, Joe! 


Your phone: 555-1234 It's great that you're coming. The drinks are already in the fridge! 
ri Click here to see who is coming. 




















图 2-17 Thanks} Ø 
2.5.7 ”显示 响应 


在 Thanks.cshtml 文 件 的 最 后 ， 添 加 一 个 a 元 系 
来 创建 一 个 链接 以 显示 即将 参加 聚会 的 人 的 列表 。 
下 面 使 用 asp-action tag helper 属 性 创建 一 个 URL， 


该 URL 指 问 一 个 名 为 ListResponse 的 操作 方法 ， 如 
RATAN: 


<p>Click <a asp-action="ListResponses">here</a> to see 


who is coming.</p> 





FAS BA PTB ET oe FF ED bh as A EEE, HORS 
看 到 它 指 同 /Home/ListResponses 这 个 URL。 这 与 
Home 控 制 器 中 的 任何 操作 方法 都 不 对 应 ， 如 果 单 
击 链接 ， 束 会 看 到 一 个 空 足 耐 。 打 开 浏 览 器 的 开 友 
者 工具 并 碍 看 服务 器 发 送 的 啊 应 ， 将 显示 404 Not 
Found〈Chrome 浏 览 锅 有 点 奇怪 ， 它 不 同 用 户 显示 
错误 消 轧 ， 但 是 第 14 章 会 解释 如 何 生成 有 意义 的 错 


RHE) 。 

















这 里 将 通过 创建 使 URL 对 应 的 目标 为 Home 控 
制 器 的 操作 方法 来 解决 这 个 问题 ， 如 代码 清单 2-17 
所 示 。 





代码 清单 2-17 在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 添加 一 个 操作 方法 





using System; 

using Microsoft.AspNetCore.Mvc; 
using PartyInvites.Models; 
using System.Ling; 


namespace PartyInvites.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 
int hour = DateTime.Now.Hour; 
ViewBag.Greeting = hour < 12 ? "Good Mornin 
g" : "Good Afternoon" ; 
return View("MyView") ; 


} 


[HttpGet] 
public ViewResult RsvpForm() { 
return View(); 


} 


[HttpPost] 
public ViewResult RsvpForm(GuestResponse guestR 
esponse) { 
Repository .AddResponse(guestResponse); 
return View( "Thanks", guestResponse); 


} 


public ViewResult ListResponses() { 
return View(Repository.Responses.Where(r => 
r.WillAttend == true)); 


新 的 操作 方法 名 为 ListResponse， 它 使 用 
Repository.Responses 属 性 作为 参数 调用 View 方 法 。 
这 残 是 操作 方法 为 强 类 型 视图 提供 数据 的 方式 。 对 
GuestResponse 对 象 的 集合 使 用 LINQ 进 行 过 滤 ， 使 
得 只 有 将 要 参加 聚会 的 啊 应 和 被 使 用 。 











ListResponse 这 个 操作 方法 没有 指定 应 该 用 于 
显示 GuestResponse 对 象 集合 的 视图 名 称 ， 这 意味 痢 
将 使 用 默认 的 命名 约定 ，MVC 将 在 Views/Home 和 
Views/Shared 文 件 夹 中 查找 名 为 
ListResponses.cshtml 的 视图 。 可 在 Solution Explorer 
中 右 击 View/ Home 文 件 夹 ， 并 从 弹出 六 蛙 中 选择 
Add — New Item 以 创建 视图 。 在 ASP.NET 类 列 中 选 
择 MVC View Page 模 板 ， 命 名 为 
ListResponses.cshtml 并 单 击 Add 按 钮 。 编 辑 狐 视图 











的 内 容 ， 如 代码 清单 2-18 所 示 。 


代码 清单 2-18 ”Views/Home 文 件 夹 下 的 ListResponses.cshtml 文 
件 的 内 容 : 显示 邀请 函 








@model IEnumerable<PartyInvites.Models.GuestResponse> 


@{ 


Layout = null; 
} 


<!DOCTYPE html> 


<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Responses</title> 
</head> 
<body> 
<h2>Here is the list of people attending the party< 
/h2> 
<table> 
<thead> 
<tr> 
<th>Name</th> 
<th>Email</th> 
<th>Phone</th> 
</tr> 
</thead> 
<tbody> 


@foreach (PartyInvites.Models.GuestResponse 
r in Model) { 
<tr> 
<td>@r.Name</td> 
<td>@r.Email</td> 
<td>@r.Phone</td> 
</tr> 


</tbody> 
</table> 
</body> 
</html> 





Razor 视 图 文件 有 .cshtml 文 件 扩展 名 ， 因 为 它 
们 是 C# 代 码 和 HTML 的 混合 体 。 你 可 以 在 代码 
清单 2-18 中 看 到 这 这 里 使 用 foreach 循 环 来 处 
象 ， 它 在 操作 方法 中 使 用 
View 方 法 传递 给 视图 。 与 原生 的 C# 中 的 foreach 循 
环 不 同 ，Razor 的 foreach 循 环 的 主体 包含 添加 到 响 
应 中 的 HTML 元 系 ， 这 些 元 系 将 被 发 送 回 浏览 
在 这 个 视图 中 ， 每 个 GuestResponse 对 象 都 会 生成 一 
个 tr 元 素 ，tr 元 素 中 又 会 包含 一 个 td 元 素 ，td 元 素 中 
是 对 象 属性 的 值 。 











要 答 看 工作 中 的 列表 ， 可 以 通过 从 Debug 沫 单 
中 选择 Start Debugging 来 运行 应 用 程序 ， 提 区 一 些 
表单 数据 ， 然 后 单 击 链接 得 看 啊 应 列表 。 你 将 看 到 
目 应 用 程序 局 动 以 来 输入 的 所 有 数据 ， 如 图 2-18 所 
示 。 视 图 呈现 数据 的 方式 有 些 简 陋 ， 但 是 现在 已 经 
足够 完成 我 们 的 功能 了 ， 本 草 后 面 将 介绍 应 用 程序 
的 其 他 样式 。 


| Responses x 


一 Œ |© localhost:57628/Home/ListResponses w| 3 


Here is the list of people attending the party 











图 2-18 输入 的 所 有 数据 


2.5.8 ”和 还 加 验证 





现在 该 向 应 用 程序 添加 数据 验证 功能 了 。 如 果 
程序 缺乏 验证 ， 用 户 就 可 以 输入 无 意义 的 数据 ， 甚 
至 提交 一 个 空 表 单 。 在 MVC 应 用 程序 中 ， 验 证 通常 





应 用 于 领域 模型 而 不 是 用 户 界 面 。 这 意味 着 你 只 在 
一 个 地 方 定义 了 验证 ， 但 能 够 在 模型 类 使 用 的 应 用 
程序 的 任何 地 方 生 效 。MVC 支 持 声 明 式 验证 规则 

(Declarative Validation Rule) ， 这 是 通过 
System.ComponentModel.DataAnnotations 命 名 空间 
中 的 Attribute 进 行 定义 的 。 这 意味 着 验证 约束 是 使 
用 标准 C# 注 解 属性 来 表示 的 。 代 码 清 单 2-19 展 示 了 
如 何 将 这 些 属性 应 用 到 GuestResponse 模 型 类 。 





代码 清单 2-19 ”在 Models 文 件 夹 下 的 GuestResponse.cs 文 件 中 添 
加 验证 以 应 用 相关 属性 





using System.ComponentModel .DataAnnotations; 


namespace PartyInvites.Models { 
public class GuestResponse { 


[Required(ErrorMessage = "Please enter your nam 
e")] 
public string Name { get; set; } 
[Required(ErrorMessage = "Please enter your ema 
il address")] 
[RegularExpression(".+\\@.+\\..+", 
ErrorMessage = "Please enter a valid email 


address") ] 
public string Email { get; set; } 


[Required(ErrorMessage = "Please enter your pho 
ne number") ] 


public string Phone { get; set; } 


[Required(ErrorMessage = "Please specify whethe 
r you'll attend") ] 


public bool? WillAttend { get; set; } 


} 





MVC 会 目 动 检测 属性 并 在 模型 绑 定 过 程 中 使 
用 它们 来 验证 数据 。 由 于 已 经 导入 包含 验证 属性 的 
命名 空间 ， 因 此 不 再 裔 要 限定 它们 的 名 称 束 可 以 引 
用 它们 。 








提 示 


正如 前 面 提 到 的 ，WillAttend 属 性 使 用 可 为 null 


的 bool 型 。 这 样 做 是 为 了 能 够 应 用 Required 注 解 属 
性 。 如 果 使 用 常规 的 bool 型 ， 那 么 通过 模型 绑 定 接 
收 到 的 值 只 有 true 或 false， 你 将 无 法 判断 用 户 是 否 
选择 了 值 。 可 空 的 bool 型 有 三 个 可 能 的 值 一 一 

true, falsefinul. WRAP RAHA, A Dae 
发 送 null， 这 让 Required 注 解 属性 能 够 报告 验证 错 
误 。 这 是 MVC 将 C# 特 性 与 HTML 和 HTTP 混 合 在 一 
起 的 一 个 很 好 的 示例 。 





你 可 以 在 控制 器 类 中 使 用 ModelState.IsValid 属 
性 来 检查 是 否 存 在 验证 问题 。 代 码 清 单 2-20 显 示 了 
如 何在 Home 控 制 器 类 里 局 用 POST 的 RsvpForm 操 作 
方法 中 检查 表单 验证 错误 。 


代码 清单 2-20 ”在 Controllers 文 件 夹 下 的 HomeController.cs 中 检 
查 表单 验证 错误 





using System; 

using Microsoft.AspNetCore.Mvc; 
using PartyInvites.Models; 
using System.Ling; 


namespace PartyInvites.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 
int hour = DateTime.Now.Hour; 
ViewBag.Greeting = hour < 12 ? "Good Mornin 
g“ : "Good Afternoon"; 
return View("MyView") ; 


} 


[HttpGet ] 
public ViewResult RsvpForm() { 
return View(); 
} 
[HttpPost ] 
public ViewResult RsvpForm(GuestResponse guestR 
esponse) { 
if (ModelState.IsValid) { 
Repository .AddResponse(guestResponse) ; 
return View( "Thanks", guestResponse) ; 
} else { 
// there is a validation error 
return View(); 


} 


public ViewResult ListResponses() { 
return View(Repository.Responses.Where(r => 
r.WillAttend == true)); 


Controller 基 类 提供 了 一 个 名 为 ModelState 的 局 
性 ， 该 属性 提供 关于 将 HTTP 请 求 数据 转换 成 C# 对 
象 的 信息 。 如 果 ModelState.IsValue 属 性 返回 true， 
那么 可 以 知道 MVC 能 够 满足 通过 GuestResponse 类 
的 属性 指定 的 验证 约束 。 因 此 验证 通过 ， 将 展现 
Thanks 视 图 。 





如 果 ModelState.IsValue 属 性 返回 false， 那 么 可 
以 知道 发 生 验 证 错误 了 。ModelState 属 性 返回 的 对 
象 提供 了 每 个 问题 的 详细 信息 ， 但 开发 人 员 并 不 需 
要 知道 细节 ， 因 为 通过 一 个 特别 有 用 的 特性 ， 无 须 
FAB BUS He Va AD View iz, FF A soak A Pe 
决 任何 问题 。 





当 MVC 演 染 视图 时 ，Razor 可 以 访问 与 请 求 相 
关 的 所 有 验证 错误 的 细节 ， 而 标签 助手 可 以 访问 细 








节 并 回 用 户 显 示 验 证 错误 。 代 码 清 单 2-21 显 示 了 如 
何 为 RsvpForm 视 图 添加 验证 用 的 标签 助手 属性 。 


代码 清单 2-21 在 位 于 Views/Home 文 件 夹 下 的 
RsvpForm.cshtml 文 件 中 添加 验证 总 结 





@model PartyInvites.Models.GuestResponse 


@{ 


Layout = null; 
} 


<!DOCTYPE html> 


<html> 
<head> 

<meta name="viewport" content="width=device-width" 
/> 

<title>RsvpForm</title> 
</head> 
<body> 

<form asp-action="RsvpForm" method="post"> 

<div asp-validation-summary="Al11"></div> 


<p> 
<label asp-for="Name">Your name:</label> 
<input asp-for="Name" /> 

</p> 

<p> 


<label asp-for="Email">Your email:</label> 
<input asp-for="Email" /> 


</p> 
<p> 
<label asp-for="Phone">Your phone:</label> 
<input asp-for="Phone" /></p> 
<p> 
<label>Will you attend?</label> 
<select asp-for="WillAttend"> 
<option value="">Choose an option</opti 
on> 
<option value="true">Yes, I'll be there 
</option> 
<option value="false">No, I can't come< 
/option> 


</select> 
</p> 
<button type="submit">Submit RSVP</button> 
</form> 
</body> 
</html> 








将 asp-validation-summary 属 性 应 用 于 div 元 素 ， 
并 在 演 染 视图 时 显示 验证 错误 列表 。asp-validation- 
summary 属 性 的 值 来 自 ValidationSummary 枚 举 ， 这 
个 枚 举 指 定 了 验证 总 结 中 将 包含 哪些 类 型 的 验证 错 
误 。 这 里 指定 包含 所 有 类 型 的 验证 错误 ， 这 是 大 多 
数 应 用 程序 开始 编写 时 的 常用 方式 ， 第 27 章 将 描述 
其 他 的 取 值 并 解释 它们 的 工作 原理 。 




















要 查看 验证 总 结 是 如 何 工作 的 ， 运 行 应 用 程 
序 ， 只 填写 Name 字 段 ， 然 后 不 输入 任何 其 他 数据 
就 提交 表单 。 你 将 看 到 的 验证 错误 如 图 2-19 所 示 。 


1- RsvpForm X 


一 CS | © localhost:57628/Home/Rs vpForm wv : 
» Please enter your email address 
» Please enter your phone number 
» Please specify whether you'll attend 

Your name: Joe 

Your email 

Your phone: 


Will you attend? Choose an option ¥ 





| Submit RSVP | 








图 2-19 ”验证 错误 





RsvpForm 这 个 操作 方法 将 不 会 演 染 Thanks 视 
图 ， 直 到 满足 应 用 到 GuestResponse 类 的 所 有 验证 约 
束 为 止 。 注 意 ， 当 Razor 使 用 验证 总 结 显示 视图 
时 ， 输 入 Name 字 段 中 的 数据 (合法 数据 〉 将 被 保 
留 并 再 次 显示 。 这 是 模型 绑 定 的 男 一 个 好 处 
化 了 表单 数据 的 工作 。 





Ivar 
[H] 





We 
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使 用 过 ASP.NET Web Forms 的 读者 知道 服务 器 
控件 〈server control) 的 概念 ， 通 过 将 序列 化 的 值 
保存 到 一 个 名 为 VIEWSTATE 的 隐藏 字段 中 ， 服 
务 器 控件 可 保持 状态 。MVC 模 型 绑 定 与 服务 器 控 
件 、 回 发 或 视图 状态 等 Web 表 单 概念 无 关 。MVC 不 
会 将 隐藏 的 _VIEWSTATE 字 段 注 入 所 泻 染 的 
HTML 页 面 。 相 反 ， 它 通过 设置 输入 元 素 的 value 属 
性 来 包含 数据 。 








标签 助手 属性 与 模型 属性 通过 元 素 关 联 了 一 个 
方便 的 特性 ， 可 以 用 来 和 模型 绑 定 结合 。 当 模型 属 
性 验证 失败 时 ， 标 签 助 手 属 性 将 生成 略 有 不 同 的 
HTML。 这 里 是 在 没有 验证 错误 时 为 “手机 号 ?字段 
生成 的 HTML: 








<input type="text" data-val="true" data-val-required="P 


lease enter your phone number" 
id="Phone" name="Phone" value=""> 








相 比 之 下 ， 以 下 是 在 用 户 提 交 表 单 而 不 将 任何 
数据 输入 文本 字段 后 (这 是 验证 错误 ， 因 为 将 
Required 验 证 属性 应 用 到 了 GuestResponse 类 的 
Phone 属 性 ) 生成 的 HTML: 


<input type="text" class="input-validation-error" data- 
val="true" 


data-val-required="Please enter your phone number" 
id="Phone" 
name="Phone" value=""> 











X FA AAA AB a GN AN FRY Zeb 示 答 助手 





属性 将 输入 元 系 添 加 a 到 一 个 名 为 input-validation- 
error 的 类 中 。 我 们 可 以 利用 这 个 特性 创建 一 个 样式 
表 ， 其 中 包含 这 个 类 的 一 些 CSS 样 式 ， 以 及 其 他 不 
同 的 HTML 标 签 助手 属性 以 丰富 显示 效果 。 














MVC 项 目 中 的 约定 是 将 交付 给 客户 的 静态 内 
容 〈 如 CSS 样 式 表 等 ) 放置 到 wwwroot 文 件 夹 中 ， 
根据 内 容 的 类 型 进行 组 织 排序 ， 所 以 CSS 样 式 表 被 
放 入 wwwroot/css 文 件 夹 ，JavaScript 文 件 则 被 放 入 


wwwroot/js 文 件 来， 等 等 。 





要 创建 一 个 CSS 样 式 表 ， 可 以 右 击 wwwroot/css 
XF, Visual Studio 的 Solution Explorer 中 ， 选 
择 Add ,New Item， 呈 机 到 客户 闹 部 分 ， 并 从 模板 
列表 中 选择 Style Sheet， 如 图 2-20 所 示 。 














Sorby: Dean 兴国 [serh ceo P] 
4 ASP.NET C 
ine ore BD HTML Page ASP.NET Core a aaa anes a 
Sane HTML style definitions 
Web 
ASP.NET 
General 
b Online 
Name: styles.ess 
`y 
图 2-20 ”创建 一 个 CSS 样 式 表 
Gy 
H -e 
提 外 


当 使 用 Web Application (Model-View- 
Controller) 模板 创建 项 目 时 ，Visual Studio 会 在 


wwwroot/css 文 件 夹 中 创建 site.css 文 件 。 可 以 忽略 这 
个 文件 ， 你 在 本 章 中 不 会 用 到 它 。 





将 文件 的 名 称 设置 为 styles.css， 单 击 Add 按 钮 
创建 CSS 样 式 表 ， 编 辑 这 个 文件 ， 如 代码 清单 2-22 
所 示 。 


代码 清单 2-22 ” wwwroot/css 文 件 夹 下 的 styles.css 文 件 的 内 容 


.field-validation-error {color: #f00;} 
.field-validation-valid { display: none; } 
.input-validation-error { border: 1px solid #f@0; ba 
ckground-color: #fee; } 

.Validation-summary-errors { font-weight: bold; color: 


#f00; } 

.Validation-summary-valid { display: none; } 

To apply this stylesheet, I have added a link element t 
o the head section of the RsvpForm 

view, as shown in Listing 2-23. 





为 了 应 用 这 个 样式 表 ， 需 要 癌 RsvpForm 视 图 的 
头 部 添加 一 个 link 元 素 ， 如 代码 清单 2-23 所 示 。 


代码 清单 2-23 ”在 Views/Home 文 件 夹 下 的 RsvpForm.cshtml 文 
件 中 应 用 样式 表 





<head> 
<meta name="viewport" content="width=device-width" 


/> 


<title>RsvpForm</title> 
<link rel="stylesheet" href="/css/styles.css" /> 


</head> 








link 元 素 使 用 href 属 性 指定 样式 表 的 位 置 。 注 
意 ，URL 中 省 略 了 wwwroot 文 件 夹 。ASP.NET 的 默 
认 配 置 包括 对 服务 静态 内 容 《〈 例 如 图 像 、CSS 样 式 
表 和 JavaScript 文 件 ) 的 文 持 ， 并 且 上 自动 将 请 求 映 射 
人 wwwroot 文 件 夹 。 第 14 章 将 详 述 ASP.NET 和 MVC 


配置 过 程 。 


o 


提 ZN 


在 处 理 样式 表 时 ， 有 一 个 特殊 的 标签 助手 ， 如 
果 有 许多 文件 可 以 管理 的 话 ， 使 用 这 个 标签 助手 将 


十 分 方便 。 详 见 第 25 草 。 


随 着 样式 表 的 应 用 ， 当 提交 数据 时 会 突出 显示 
验证 错误 ， 如 图 2-21 所 示 。 


Your name: Joe 


Your emait E) 
Yourphone: i] 


Will you attend? | Choose an option ¥ 








| Submit RSVP | 





图 2-21 ”自动 突出 显示 的 验证 错误 
2.5.9 ”设置 内 容 样 式 


至 此 ， 应 用 程序 的 所有 功能 目标 都 已 完成 ， 但 
是 应 用 程序 的 整体 外 观 很 又 。 当 你 使 用 Web 
Application (Model-View-Controller) 模板 创建 项 目 





时 ，Visual Studio 已 经 内 置 安装 了 一 些 钊 见 的 开源 
库 。 虽 然 作 者 不 喜欢 使 用 模板 项 目 ， 但 作者 确实 喜 
欢 微软 选择 的 库 。 其 中 一 个 叫 作 Bootstrap， 它 是 一 
个 很 好 的 CSS 框 如， 最 初 是 由 Twitter 开 有 的， 目前 
己 经 成 为 一 个 主要 的 开源 项 目 ， 并 且 已 经 成 为 Web 
应 用 程序 开发 的 主流 框架 之 一 。 


YO 
vy we 
vc 屋 


在 撰写 本 书 时 ，Bootstrap 3 是 当前 最 新 版 本 ， 
并 且 第 4 代 厂 本 已 在 开发 。 微 软 可 能 会 选择 在 Visual 
Studio 的 后 期 版 本 中 更 新 Web Application (Model- 
View-Controller) 模板 所 使 用 的 Bootstrap 版 本 ， 这 
可 能 会 导致 内 容 以 不 同 的 方式 显示 。 这 对 于 本 书 的 





其 他 章节 来 说 并 不 是 问题 ， 因 为 本 书 将 展示 如 何 显 
式 地 指定 菏 个 库 的 版 本 ， 以 便 得 到 预期 的 结 


1. 设置 欢迎 视图 


Bootstrap 的 基本 特性 是 通过 运用 于 HTML 元 系 
的 类 起 作用 的 ， 这 些 类 与 定义 在 
wwwroot/ib/bootstrap 文 件 夹 中 的 CSS 选 择 占 相关 
联 。Bootstrap 的 相关 细节 可 以 从 getbootstrap 网 站 获 
取 。 你 也 可 以 通过 代码 清单 2-24 中 的 
MyView.cshtml 视 图 文件 看 到 如 何 将 一 些 基本 样式 
应 用 到 视图 文件 。 








代码 清单 2-24 添加 Bootstrap 到 Views/Home 文 件 夹 下 的 
MyView.cshtml 文 件 中 


@{ 
Layout = null; 
} 


<!DOCTYPE html> 


<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Index</title> 
<link rel="stylesheet" href="/1ib/bootstrap/dist/cs 
s/bootstrap.css" /> 
</head> 
<body> 
<div class="text-center"> 
<h3>We're going to have an exciting party!</h3> 
<h4>And you are invited</h4> 
<a class="btn btn-primary" asp-action="RsvpForm 
">RSVP Now</a> 
</div> 
</body> 
</html> 





X EAI Y linkt, CMhref/a tEn AH FA 
wwwroot/lib/bootstrap/dist/css 文 件 夹 加 载 
bootstrap.css 文 件 。 通 常 约定 将 第 三 方 的 CSS 和 
JavaScript 包 a 中 ， 第 6 章 将 

详 述 用 于 管 包 的 工具 。 








A Bootstrap steele, a BO oR ET A sh 


化 。 这 只 是 一 个 简单 的 示例 ， 所 以 只 使 用 少量 的 


Bootstrap CSS% text-center、btn 以 及 btn- 





primary» 


text-center HJ LETRA TORRARE 
中 。btn 类 用 于 修饰 button、input 或 其 他 作为 按钮 使 
用 的 元 素 的 样式 ， 而 btn-primary 类 用 于 指定 按钮 的 
颜色 范围 。 你 可 以 通过 运行 应 用 程序 看 到 效果 ， 如 
图 2-22 所 示 。 





€> CO bad 


We're going to have an exciting party! 
And you are invited 











图 2-22 ”样式 化 视图 的 效果 
2. 设置 RsvpForm (电子 回复 ) 表单 视图 


Bootstrap 定 义 了 可 以 用 于 样式 表 的 类 。 这 里 不 


打算 详细 介绍 ， 但 是 会 展示 如 何 将 这 些 类 应 用 到 代 
码 清单 2-25 中 。 


代码 清单 2-25 ”在 Views/Home 文 件 夹 下 的 RsvpForm.cshtml 文 
件 中 添加 Bootstrap 





@model PartyInvites.Models.GuestResponse 


@{ 
} 


<!DOCTYPE html> 


Layout = null; 


<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>RsvpForm</title> 
<link rel="stylesheet" href="/css/styles.css" /> 
<link rel="stylesheet" href="/1ib/bootstrap/dist/cs 
s/bootstrap.css" /> 
</head> 
<body> 
<div class="panel panel-success"> 
<div class="panel-heading text-center"><h4>RSVP 
</h4></div> 
<div class="panel-body"> 
<form class="p-a-1" asp-action="RsvpForm" m 
ethod="post"> 
<div asp-validation-summary="Al1"></div> 


<div class="form-group"> 
<label asp-for="Name">Your name:</1 


abel> 
<input class="form-control" asp-for 
="Name" /> 
</div> 
<div class="form-group"> 
<label asp-for="Email">Your email:< 
/label> 
<input class="form-control" asp-for 
="Email" /> 
</div> 
<div class="form-group"> 
<label asp-for="Phone">Your phone:< 
/label> 
<input class="form-control" asp-for 
="Phone" /> 


</div> 
<div class="form-group"> 
<label>Will you attend?</label> 
<select class="form-control" asp-fo 
r="WillAttend"> 


<option value="">Choose an opti 
on</option> 
<option value="true">Yes, I'll 
be there</option> 
<option value="false">No, I can 
't come</option> 
</select> 
</div> 
<div class="text-center"> 
<button class="btn btn-primary" typ 
e="submit"> 
Submit RSVP 
</button> 


</div> 
</form> 
</div> 
</div> 
</body> 
</html> 





这 个 示例 中 的 Bootstrap 类 创建 了 一 个 标题 ， 只 
是 为 了 提供 一 下 结构 布局 。 为 了 对 表单 进行 样式 
化 ， 使 用 了 form-group 类 ， 该 类 用 于 对 包含 标签 和 
相关 输入 或 选择 的 元 素 进 行 样式 化 。 你 可 以 在 图 2- 
23 中 看 到 样式 的 效果 。 


€ C |© localhost:57628/Home/Rsvp ad 
RSVP 

Your nam 

Your email: 

Your ph 


Will you attend? 


Choose an option 


Submit RSVP 











图 2-23 ”样式 化 RsvpForm 视 图 的 效果 


3. 样式 化 Thanks 视 图 


下 一 个 要 样式 化 的 视图 文件 是 Thanks.cshtml， 
你 可 以 在 代码 清单 2-26 中 看 到 具体 是 如 何 完 成 的 ， 
使 用 的 CSS 类 与 在 其 他 视图 中 使 用 的 相似 。 为 了 使 
应 用 程序 更 容易 管理 ， 尽 可 能 避免 重复 代码 和 标记 








是 一 条 很 好 的 原则 。MVC 提 供 了 几 个 特性 来 帮助 减 
少 重 复 ， 后 面 的 章节 将 对 此 进行 描述 。 这 些 特性 包 
括 Razor 布 局 、 分 部 视图 和 视图 组 件 。 


代码 清单 2-26 ”在 Thanks.cshtml 文 件 中 使 用 Bootstrap 





@model PartyInvites.Models.GuestResponse 


@{ 
Layout = null; 
} 


<!DOCTYPE html> 


<html> 
<head> 


<meta name="viewport" content="width=device-width" 
/> 
<title>Thanks</title> 
<link rel="stylesheet" href="/1ib/bootstrap/dist/cs 
s/bootstrap.css" /> 
</head> 
<body class="text-center"> 
<p> 
<h1>Thank you, @Model.Name!</h1> 
@if (Model.WillAttend == true) { 
@:It's great that you're coming. The drinks 
are already in the fridge! 
} else { 
@:Sorry to hear that you can't make it, but 
thanks for letting us know. 
} 
</p> 
Click <a class="nav-link" asp-action="ListResponses 
">here</a> 
to see who is coming. 
</body> 
</html> 





图 2-24 显 示 了 样式 化 Thanks 视 图 的 效果 。 


二 CS |© localhost:57628/Home/RsvpForm w| : 


Thank you, Joe! 


It's great that you're coming. The drinks are already in the fridge! 





Click here to see who is coming. 








图 2-24 ”样式 化 Thanks 视 图 的 效果 


4. 样式 化 列表 视图 


最 后 一 个 需要 样式 化 的 视图 是 ListResponses， 
它 是 一 个 用 于 展示 参加 派对 人 员 信 息 的 列表 。 在 样 
式 化 内 容 时 遵循 与 所 有 Bootstrap 样 式 相同 的 基本 操 
作 ， 如 代码 清单 2-27 所 示 。 











代码 清单 2-27 在 Views/Home 文 件 夹 下 的 ListResponses.cshtml 
文件 中 添加 Bootstrap 





@model IEnumerable<PartyInvites.Models.GuestResponse> 


@{ 
} 


<!DOCTYPE html> 


Layout = null; 


<html> 
<head> 

<meta name="viewport" content="width=device-width" 
/> 

<link rel="stylesheet" href="/1ib/bootstrap/dist/cs 
s/bootstrap.css" /> 

<title>Responses</title> 
</head> 
<body> 

<div class="panel-body"> 


<h2>Here is the list of people attending the pa 
rty</h2> 
<table class="table table-sm table-striped tabl 
e-bordered"> 
<thead> 
<tr> 
<th>Name</th> 
<th>Email</th> 
<th>Phone</th> 
</tr> 
</thead> 
<tbody> 
@foreach (PartyInvites.Models.GuestResp 
onse r in Model) { 
<tr> 
<td>@r.Name</td> 
<td>@r.Email</td> 
<td>@r.Phone</td> 
</tr> 


} 
</tbody> 
</table> 
</div> 
</body> 
</html> 





图 2-25 展 示 了 样式 化 ListResponses 视 图 的 效 
末 。 将 这 些 样式 添加 到 视图 中 ， 即 可 完成 这 个 应 用 
程序 。 应 用 程序 现在 已 满足 所 有 的 开发 目标 ， 并 且 
外 观 上 也 有 了 很 大 的 改进 。 








Here is the list of people attending the party 


Name Email Phone 
Joe joe @example.com 555-1234 
alice@example.com 


Bob bob@example.com 258-2345 





图 2-25 ”样式 化 ListResponses 视 图 的 效果 
2.6 ”小结 


在 本 章 中 ， ee MVC 项 目 ， 
并 使 用 它 构造 了 一 个 简单 的 数据 录入 程序 ， 你 看 到 
J ASP.NET Core MVC 的 大 体 架 构 和 方法 。 本 章 跳 
过 了 一 些 关 键 特性 〈 包 括 Razor 语 法 、 路 由 和 测 
试 ) ， 但 是 后 面 的 章节 将 深入 讨论 这 些 主题 。 下 一 
草 将 摘 述 MVC 的 设计 模式 ， 这 是 使 用 ASP.NET 
Core MVC 实 现 有 效 开 发 的 基础 。 








63H MVC 模式、 项 目 与 约定 


在 深入 探讨 ASP.NET Core MVC 的 核心 内 容 之 
前 ， 最 好 熟悉 一 下 MVC 的 设计 模式 、 隐 藏 在 后 面 的 
核心 思想 ， 以 及 将 MVC 项 目 转 换 为 ASP.NET Core 
MVC 项 目的 方法 。 你 可 能 已 经 对 本 章 将 要 讨论 的 一 
些 想法 和 约定 有 所 了 解 ， 特 别 是 如 果 之 前 做 过 
ASP.NET 或 C# 开 发 工作 的 话 。 如 果 没 有 ， 建 议 仔 细 
研读 一 下 本 章 ， 以 加 深 对 MVC 底 层 知 识 的 理解 ， 从 
而 帮助 你 更 好 地 投入 到 本 书 接 下 来 的 框 染 特性 学 习 
中 。 











3.1 MVC 简 史 


MVC (Model-View-Controller， 模 型 -视图 - 控 
制 改 )》 在 20 世 纪 70 年 代 后 期 束 已 经 出 现 ， 产 生 于 


Xerox PARC (施乐 公 司 的 由 洛 阿 尔 托 研究 中 心 》 

的 Smalltalk 项 目 ， 当 时 被 构思 为 早期 GUIY 用 程序 
的 一 种 组 织 方式 。 最 初 的 MVC 模 式 的 某 些 细节 依赖 
于 Smalltalk 特 有 的 概念 ， 如 屏幕 和 工具 等 ， 但 是 其 
更 广泛 的 概念 仍然 适用 于 现在 的 应 用 程序 ， 而 且 特 
别 适 用 于 Web 应 用 程序 。 


3.2 ”MVC 模式 


从 高 级 术语 角度 看 ，MVC 模 式 意 味 着 一 个 
MVC 应 用 程序 将 被 分 成 至 少 3 部 分 。 





。 柑 型 ， 它 包含 或 代表 用 户 使 用 的 数据 。 

。 视 图 ， 它 用 来 呈现 模型 中 的 一 些 用 户 界 面 。 

。 控制 如 ， 它 用 来 处 理 输入 请 求 ， 执 行 模型 操 
作 ， 并 选择 泻 染 给 用 户 的 视图 。 











MVC 染 构 的 每 一 部 分 都 是 被 明 确 界 定 和 目 包 
含 的 ， 我 们 称 之 为 天 注 点 分 离 。 模 型 中 操纵 数据 的 


逻辑 仅仅 在 模型 内 部 ， 展 示 数 据 的 逻辑 仅仅 在 视图 
中 ， 处 理 用 户 请 求 和 输入 的 代码 仅仅 包含 在 控制 器 
中 ， 每 一 部 分 都 有 明确 的 分 工 。 这 样 ， 无 论 应 用 程 
序 有 多 大 ， 在 整个 生命 周期 中 它 都 会 变 得 易于 维护 
和 扩充 。 





3.2.1 模型 


模型 中 包含 了 用 户 使 用 的 数据 。 有 两 种 类 型 的 
模型 : 一 种 是 视图 模型 ， 只 代表 从 控制 坪 传 递 到 视 
图 的 数据 ， 夯 一 种 是 领域 模型 ， 包 含 业务 域 中 的 效 
据 ， 以 及 创建 、 存 储 和 操纵 这 些 数据 的 操作 、 转 换 
和 规则 ， 这 些 统称 为 模型 逻辑 。 








模型 是 应 用 程序 工作 的 定义 域 。 例 如 ， 在 银行 
应 用 程序 中 ， 和 模型 代表 了 应 用 程序 文 持 的 任何 事 
情 ， 比 如 账户 、 总 账 、 客 户 的 信用 额度 以 及 模型 中 
可 以 操控 数据 的 操作 ， 如 存 球 和 提 丈 。 模 型 也 负 贡 





维护 整体 的 状态 和 数据 的 一 致 性 ， 比 如 ， 确 保 所 有 
的 交易 都 家 添加 到 分 关 账 中 并 且 客 户 没 有 从 账 己 中 
取 走 超出 账户 余额 的 钱 。 











对 于 MVC 的 每 个 组 件 ， 接 下 来 分 别 描述 哪些 


内 容 应 该 包含 在 内 ， 哪 些 内 容 不 应 该 包含 在 内 。 在 
应 用 程序 中 使 用 MVC 构 建 模型 时 ， 注 意 以 下 几 扣 : 











。 包含 领域 数据 ; 

。 包含 用 户 创 建 、 官 理 和 修改 领域 数据 的 逻辑 ; 
。 提 供 一 个 可 以 公开 模型 数据 和 操作 的 干净 的 
API。 


以 下 做 法 是 错误 的 : 


。 其 露 模型 数据 是 怎样 家 获取 或 组 织 的 〈 换 句 话 
次， 数据 存储 机 制 的 细节 不 能 又 露 给 控制 右 和 
视图 ) ; 

。 包 含 基 于 用 户 交 互 改 变异 型 的 多 辑 《〈 因 为 那 是 
Peril aH LE); 








(HR RAP ERARE CAA AS EAA 
工作 ) 。 
保证 模型 与 控制 顷 和 视图 人 逻辑 分 离 的 好 处 是 可 
以 使 逻辑 的 测试 工作 更 加 人 简 捍 (第 7 革 将 会 介绍 早 
元 测试 ) 。 不 仅 如 此 ， 这 样 做 还 可 以 使 整个 应 用 程 
序 的 优化 和 维护 工作 变 得 简单 。 


p 


提 示 
许多 不 熟悉 MVC 模 式 的 开发 者 对 数据 模型 中 
包含 逻辑 处 理 的 事情 感到 困惑 ， 请 相信 ，MVC 模 式 
的 目标 是 将 数据 和 逻辑 分 离 。 有 些 人 认为 MVC 模 式 
的 目标 是 将 一 个 应 用 划分 成 3 个 功能 区 域 ， 每 个 功 
能 区 域 都 包含 逻辑 和 数据 模块 ， 其 实 这 是 误解 





MVC 模 式 的 目标 并 不 是 要 从 模型 中 消除 逻辑 ， 相 
反 ， 而 是 确保 模型 中 只 包含 用 于 创建 和 管理 模型 数 
据 的 逻辑 。 





3.2.2 ”控制 器 


控制 硕 在 MVC 模 型 中 古 数据 模型 和 视图 之 间 
联系 的 纽 囊 。 控 制 右 定义 了 对 数据 模型 进行 操作 的 
业务 逻辑 的 动作 ， 以 及 视图 给 用 户 提 供 视 图 数据 的 
动作 。 


使 用 MVC 模式 构建 控制 占 时 应 该 包含 基于 用 
户 交 互 更 新 模型 的 动作 ; 不 应 该 包含 管理 数据 外 观 
的 逻辑 “〈 那 是 视图 的 工作 ) ， 同 时 不 应 该 包含 管理 
数据 持久 化 的 逻辑 〈 那 是 模型 的 工作 ) 。 


3.2.3 ”视图 








视图 包含 了 回 用 户 展 示 数 据 或 者 从 用 户 那 里 获 

取 数 据 以 便 控制 占 使 用 的 迎 辑 。 视 图 应 该 包含 需要 

展示 给 用 户 的 馆 辑 和 标注 ， 不 应 该 包含 复杂 的 馆 辑 

《这 些 最 好 放 在 控制 器 中 ) 和 创建 、 存 储 或 操控 域 
模型 的 逻辑 。 











视图 可 以 包含 逻辑 ， 但 是 包含 的 逻辑 应 该 比较 
简单 或 者 很 少 使 用 。 在 视图 中 放置 的 任何 事情 ， 即 
使 是 最 简单 的 方法 调用 或 表达 式 ， 也 会 使 整个 应 用 
变 得 难以 测试 和 维护 。 








3.2.4 MVC 的 ASP.NET 实 现 


顾名思义 ，ASP.NET Core MVC 使 MVC 模 式 适 
用 于 ASP.NET 和 C# 开 发 。 在 ASP.NET Core MVC 
中 ， 控 制 器 是 C# 关 ， 通 音 派 生 于 微软 的 
AspNetCore.Mvc.Controller 类 。 从 控制 器 派生 而 来 
的 类 中 的 每 个 公有 方法 都 是 一 种 操作 方法 ， 与 一 个 





URL 相 关联 。 当 一 个 请 求 被 友 送 给 一 个 与 操作 方法 
相关 联 的 URL 时 ， 便 会 执行 操作 方法 中 的 语句 ， 以 
执行 领域 模型 上 的 一 些 操作 ， 然 后 选择 一 个 视图 显 
示 给 客户 端 。 图 3-1 显 示 了 控制 占 、 模 型 和 视图 之 
间 的 这 种 交互 。 





图 3-1 MVC 应 用 程序 中 的 交互 


ASP.NET Core MVC 使 用 名 为 Razor 的 视图 引擎 
组 件 来 负责 处 理 视图 ， 以 生成 浏览 器 需要 的 结果 。 
Razor 视 图 是 一 些 包 含 C# 光 辑 的 HTML 模 板 ， 用 于 
处 理 模 型 数据 以 产生 随 着 模型 变化 而 生成 的 动态 内 


IP 


容 。 第 5 和 章 将 会 介绍 Razor 的 工作 原理 。 








ASP.NET Core MVC 对 领域 模型 的 实现 没有 任 
何 约 束 。 你 可 以 使 用 常规 的 C# 对 象 创建 模型 ， 并 且 


可 以 使 用 .NET 文 持 的 任何 数据 库 、 对 象 关 系 映 射 
(ORM) 框架 或 者 .NET 文 持 的 其 他 数据 工具 来 实 
现 持 久 化 。 


单 页 应 用 程序 


Web 应 用 程序 开 有 有 历史 倾 问 于 将 浏览 右 视 为 呈 
现 HIML 和 啊 应 鼠标 单 击 的 简单 显示 设备 ， 这 称 为 
Web 应 用 程序 的 往返 样式 。 每 次 用 户 单 击 链接 时 ， 
都 会 向 ASP.NET Core MVC 应 用 程序 发 送 一 个 HTTP 
请 求 ， 在 这 种 应 用 程序 中 ， 控 制 器 选择 一 个 由 
Razor = ILF RIZ LD bas ALA, ME Ta) FP Se 
示 一 个 新 的 HTML 页面。 所 有 的 逻辑 、 数 据 和 状态 
都 存在 于 ASP.NET Core MVC 服 务 器 中 ， 这 简化 了 
开发 过 程 ， 意 味 着 除了 确保 浏览 器 能 够 处 理 Razor 
视图 中 包含 的 HTML 功 能 外 ， 不 必 太 关注 浏览 器 


相 比 之 下 ， 单 页 应 用 程序 将 浏览 器 合并 到 应 用 
程序 平 人 台中。 服务 器 负责 管理 应 用 程序 的 数据 ， 而 
运行 浏览 器 的 JavaScript 代 人 码 则 请 求 数据 ， 将 其 显示 
给 用 户 ， 并 啊 应 用 户 交 互 。 在 单 页 应 用 程序 中 ， 模 
ALS ALPS Af till ae FR SH ad a AIRS Aik o 





应 用 程序 的 ASP.NET Core MVC 服 务 器 部 分 提 
供 对 应 用 程序 _ 的 访问 ， 而 不 是 将 完整 的 HTML 
页 面 发 送 到 浏览 器 ， 这 些 数据 是 由 JavaScript 框 以 
( ee ) 查询 和 显示 的 。 








单 页 应 用 程序 可 能 比 往返 应 用 程序 更 具 啊 应 
性 ， 但 它们 的 创建 更 复杂 ， 需 要 同时 具备 C# 和 
JavaScript 技 能 才能 进行 有 效 的 开 友 ， 难 上 度 不 可 低 
估 。 第 20 章 将 演示 如 何 使 用 ASP.NET Core MVC 来 
提供 此 类 应 用 程序 中 的 数据 ， 但 不 会 演示 单 页 应 用 
程序 开发 。 作 者 最 喜欢 的 JavaScript 框 架 是 
Angular， 如 果 要 在 ASP.NET Core MVC 中 使 用 














Angular， 请 参阅 作者 编写 的 另 一 本 书 
for ASP.NET Core MVC. 


Angular 


3.3 MVC 与 其 他 模式 的 比较 


当然 ，MVC 并 不 是 唯一 的 软件 架构 模式 。 还 
有 很 多 其 他 的 模式 ， 并 且 其 中 的 一 些 至 少 曾经 是 非 
常 流行 的 。 通 过 比较 ， 你 也 可 以 了 解 关 于 MVC 的 更 
多 知识 。 接 下 来 的 章节 将 简要 介绍 几 个 创建 应 用 的 
不 同方 法 ， 并 将 它们 与 MVC 进 行 对 比 。 一 些 与 
MVC 大 同 小 异 ， 其 他 一 些 则 完全 不 同 。 








并 不 是 说 MVC 对 所 有 场景 都 是 最 佳 模式 。 作 
者 主张 选取 最 佳 方法 来 解决 手头 的 问题 。 你 会 看 
到 ， 在 茶 些 场景 下 ， 有 些 其 他 模 陈 与 MVC 的 表现 相 
当 ， 其 至 要 优 于 MVC。 在 选择 模式 时 ， 建 议 做 出 明 








智 的 选择 。 
3.3.1 “智能 UI” 模 式 

最 常用 的 设计 模式 之 一 称 为 “和 佛 能 UI” 模 式 。 大 
多 数 程 序 员 在 其 职业 生涯 中 有 过 创建 佛 能 UI 程序 的 


经 历 。 如 果 使 用 过 Windows Forms 或 ASP.NET Web 
Forms， 那 你 一 定 也 有 这 样 的 经 历 。 





要 创建 一 个 UI 应 用 程序 ， 通 和 营 ， 开 及 人 员 会 通 
过 把 一 组 组 件 或 控件 拖 放 到 设计 界面 或 画布 的 方式 
来 构建 用 户 界 面 。 控 件 可 以 创建 用 户 的 按压 按钮 事 
件 、 单 击 事件 、 鼠 标 移动 事件 以 与 用 户 区 互 。 开 及 
人 员 为 控件 的 这 些 事件 编写 一 系列 事件 处 理 代 码 。 
当 特 定 组 件 的 特定 事件 被 触及 时 便 会 调用 这 些 代 
码 。 这 就 创建 了 一 种 单 厂 式 的 应 用 程序 ， 如 图 3-2 
所 示 。 处 理 用 户 界 面 与 业务 逻辑 的 代码 是 混合 在 一 
起 的 ， 它 们 没有 做 分 离 。 定 义 输入 数据 、 执 行 数据 

















查询 或 修改 用 户 账 扎 的 代码 放 段 都 已 按期 望 的 事件 
顺序 灰 合 在 一 起 。 


-=D 持久 性 
(通常 用 于 
-- 据 库 ) 





图 3-2 ”智能 UI 模式 


智能 UI 项 目 非 常 适合 简单 的 项 目 ， 因 为 你 很 快 
就 可 得 到 一 些 很 好 的 结果 《〈 你 将 会 在 第 8 章 看 到 ， 
MVC 开 发 在 交付 结果 之 前 需要 做 一 些 精 心 的 准备 工 
作 和 前 期 投入 ) 。 智 能 UI 项 目 也 适用 于 用 户 界面 的 
原型 开发 。 这 些 界 面 设计 工具 确实 是 很 不 错 的 。 如 
果 你 正在 与 客户 沟通 并 且 正 需要 捕获 客户 对 外 观 和 
接口 流程 的 需求 ， 那 么 乔 能 UI 系统 可 以 帮助 你 以 快 
速 响应 的 方式 生成 和 测试 一 些 不 同 的 方案 。 








智能 UI 模式 最 大 的 缺点 就 是 难以 维护 和 扩展 。 





将 领域 模型 与 带 有 用 户 界 面 代码 的 业务 逻辑 混搭 在 
一 起 会 导致 工作 的 重复 。 换 言 之 ， 为 了 文 持 新 增加 
的 组 件 ， 需 要 复制 并 粘贴 相同 的 业务 逻辑 代码 片 

段 。 碍 找 所 有 重复 的 部 分 并 修改 错误 是 非 钊 难 的 事 
情 。 要 添加 新 的 功能 而 不 影响 己 有 的 功能 是 几乎 不 
可 能 的 ， 对 镶 能 UI 应 用 程序 进行 测试 也 是 一 件 难 

事 。 唯 一 的 办 迁就 是 模拟 用 户 的 交互 行为 ， 这 项 工 
作 不 仅 效 末 不 理想 ， 而 且 很 难保 证 有 一 个 全 面 的 训 




















在 MVC 中 ， 智 能 UI 模式 通 闸 是 一 种 有 反 模 式 
Canti-pattern) 。 这 种 反 模 式 的 出 现 ， 公 少 在 某 些 
地 方 ， 是 因为 大 多 数 人 是 在 经 历 了 长 期 的 乔 能 UIMY 
用 程序 开发 与 维护 导致 的 失控 之 后 ， 才 来 到 MVC 世 

界 以 寻求 另 一 种 开发 方案 。 








男 外 ， 拒 绝 难 以 控制 的 智能 UI 模式 是 错误 的 。 
并 不 是 镶 能 UI 模 式 中 的 所 有 东西 都 那么 不 坊 ， 其 中 


也 有 很 多 积极 的 方面 。 智 能 UI 模式 是 非常 易于 开 友 
的 ， 并 且 开 发 起 来 速度 比较 快 。 组 件 和 设计 工具 方 
面 的 开发 商 投入 很 大 的 精力 ， 使 得 用 户 的 开发 经 历 
尽量 愉悦 ， 即 使 几乎 没有 任何 开发 经 验 的 人 在 几 人 小 
时 内 也 可 以 开发 出 具有 专业 外 观 和 合理 功能 的 应 
用 。 








镶 能 UI 应 用 最 大 的 暗 点 是 可 维护 性 着 ， 但 不 会 
在 小 型 开 友 项 目 中 出 现 。 如 末 要 为 小 客户 开发 一 球 
简单 的 工具 ， 那 么 智能 UI 应 用 是 很 好 的 选择 ， 
MVC 应 用 程序 的 额外 复杂 性 则 根本 无 法 保证 。 











智能 UI 必 用 中 可 能 会 出 现 维护 问题 的 地 方 是 业 
务 逻 辑 ， 业 务 逻 辑 横路 多 个 应 用 以 至 于 改变 或 增加 
功能 都 是 十 分 艰难 的 。 模 型 -视图 (model-view) 28 
构 则 为 此 做 了 改进 ， 它 将 业务 逻辑 抽取 出 来 形成 单 


独 的 域 模型 。 这 样 做 之 后 ， 数 据 、 处 理 过 程 和 规则 
都 集中 在 应 用 程序 中 的 同一 个 部 件 中 ， 如 图 3-3 所 


ZN o 
请 求 --B 持久 性 
UI (通常 用 于 
(视图 ) 模型 描述 关系 数 
响应 <+--， 据 库 ) 


模型 -视图 架构 可 以 说 是 对 智能 UI 模式 的 一 种 
整体 上 的 改进 ， 比 方 说 更 加 易于 维护 了 ， 但 同时 也 
来 带 来 两 个 问题 。 第 一 个 问题 ， 因 为 UI 和 域 模型 是 
紧密 结合 的 ， 所 以 对 其 中 任何 一 个 进行 单元 测试 都 
比较 困难 。 第 二 个 问题 来 自 实践 而 不 是 模式 的 定 
义 。 模 型 通常 会 包含 大 量 的 数据 访问 代码 ， 其 实 并 
不 需要 这 样 ， 但 通常 是 这 样 的 ， 这 就 意味 着 数据 模 
型 不 仅仅 包含 业务 数据 、 操 作 和 规则 。 











3.3.3 经 典 的 3 层 架 构 


为 了 解决 “模型 -视图 ”架构 存在 的 问题 ， 可 使 用 
3 层 模 式 〈 见 图 3-4) 将 持久 性 代码 从 域 模型 分 离 出 
来 并 放置 在 一 个 新 的 组 件 中 ， 这 个 组 件 称 作 数据 访 
问 层 (DAL) ) 。 





图 3-4 3 层 模式 








3 层 架 构 是 应 用 程序 中 使 用 最 广泛 的 模式 。 它 
对 UI 的 实现 方式 没有 限制 ， 并 且 不 需要 很 复杂 的 操 
作 残 可 以 实现 很 好 的 关注 点 分 离 (SoC)。 男 外 ， 
我 们 注意 到 ， 有 了 数据 访问 层 (DAL) ， 单 元 测试 
也 会 变 得 相对 更 容易 一 些 。 我 们 可 以 很 容易 地 观察 
到 经 典 的 3 层 架 构 应 用 程序 和 和 MVC 模式 的 相似 之 
处 。 不 同 的 是 ， 当 UI 层 直接 耘 合 到 GUI 框架 《例如 
Windows 窗 体 或 ASP.NET Web 窗 体 ) 的 click 事 件 
时 ， 要 自动 地 执行 单元 测试 几乎 是 不 可 能 的 。 由 于 











3 层 染 构 应 用 程序 的 UI 部 分 可 以 很 复杂 ， 因 此 有 很 
多 代码 无 法 严格 测试 。 


最 坏 情 况 下 ，3 层 架构 在 UI 层 严重 缺乏 约束 ， 
也 就 是 说 ， 许 多 此 类 没有 真正 实现 关注 点 分 离 
(SoC) 的 应 用 程序 ， 痢 被 错误 地 认为 是 智能 UI 应 
用 程序 。 随 之 而 来 的 束 是 最 坏 结果 一 一 无 法 测试 、 
难以 维护 且 极 其 复杂 的 应 用 程序 诞生 了 。 





3.3.4 MVC 的 多 样 性 


前 面 已 经 介绍 了 MVC 应 用 程序 的 核心 设计 原 
则 ， 尤 其 是 ASP.NET Core MVC 方 面 的 内 容 ， 还 解 
释 了 MVC 模 式 与 其 他 模式 不 同 的 方面 以 及 为 适应 项 
目 范围 和 目的 对 MVC 所 做 的 添加 、 调 整 和 调节 工 
作 。 下 面 简要 介绍 MVC 最 普 遇 的 两 种 变化 。 了 解 这 
些 变化 对 于 使 用 ASP.NET Core MVC 并 没有 太 大 的 
帮助 ， 这 里 只 是 为 了 保证 信息 的 完整 ， 因 为 你 将 听 








到 许多 在 讨论 软件 模式 时 用 到 的 术语 。 





1. MVP (Model-View-Presenter， 模 型 -视图 -时 现 
器 ) 模式 

MVP 是 MVC 的 一 种 变 体 ， 以 便 更 容易 地 适应 
状态 的 变化 ， 例 如 Windows 窗 体 或 ASP.NET Web 窗 
体 。 为 了 得 到 最 好 的 智能 UI 模 式 而 不 引起 通 第 会 伴 
随 而 来 的 错误 ， 这 值得 答 试 。 


在 这 种 模式 中 ， 呈 现 郁 具有 与 MVC 控 制 右 相 
同 的 职责 ， 但 它 与 状态 化 视图 具有 更 直接 的 关系 ， 
根据 用 户 的 输入 和 动作 ， 直 接管 理 痢 UI 组 件 中 显示 
的 数据 。MVP 模 式 有 以 下 两 种 实现 。 














IJA] (passive view) 实现 ， 在 这 种 实现 
中 ， 视 网 不 包含 馆 辑 。 视 图 是 UI 控 件 的 容器 ， 

由 呈现 器 直接 进行 操纵 。 

监管 控制 硕 (supervising controller) 实现 ， 在 这 
种 实现 中 ， 视 图 可 能 要 负责 一 些 具 有 表现 逻辑 


的 元 系 ， 如 数据 绑 定 ， 并 被 给 予 对 领域 模型 数 
据 源 的 引用 。 








这 两 种 实现 方式 之 间 的 差别 涉及 视图 如 何 智 能 
化 。 任 何 一 种 方式 下 ， 呈 现 器 与 GUI 框架 都 是 解 耦 
AJ, OR ASE fe et SL ae YB fa] A A il 
试 。 


2. MVVM (Model-View-View Model， 模 型 - 视 
图 -视图 模型 模式 





MVVM 模 式 是 MVC 的 最 新 变 体 ， 源 于 微软 ， 
并 应 用 于 WPF。 在 MVVM 模 式 中 ， 模 型 和 视图 具有 
与 MVC 相 同 的 作用 。 不 同 的 是 MVVM 中 关于 视图 
模型 的 概念 ， 视 图 模型 是 用 户 界 面 的 一 种 抽象 表 
示 ， 它 既 骏 露 了 视图 中 待 显 示 的 数据 ， 也 烘 露 了 能 
够 通过 UI 进行 的 操作 。 与 MVC 控 制 器 不 同 ， 
MVVM 视 图 模型 没有 视图 (或 者 任何 特定 UI 技术 ) 
的 概念 。MVVM 视 图 使 用 WPF 的 绑 定 (binding) 




















ARTE, REL Pa ee TE CR SR EHH oR H 
BNF EEL ER HE i CAR) 与 视图 模型 暴露 的 属性 双 辣 地 
关联 在 一 起 。 


G 


提 ZN 


MVC 也 使 用 术语 视图 模型 (view model) , {8 
指 的 是 一 种 简单 的 模型 类 ， 只 用 于 从 控制 右 癌 视图 
传递 数据 。 而 领域 模型 (domain model) 则 相反 ， 
指 的 是 数据 、 操 作 以 及 规则 的 完整 表示 。 





3.4 ASP.NET Core MVC 项 日 


在 创建 一 个 新 的 ASP.NET MVC 项 目 时 ，Visual 
Studio 会 为 你 提供 项 目 中 需要 的 一 些 初 始 内 容 选 
项 。 这 样 不 仅 可 以 为 新 手 开 及 人 员 简 化 整个 学 习 过 
程 ， 并 且 可 以 应 用 一 些 节省 时 间 的 最 佳 实践 来 完成 
常见 的 功能 和 任务 。 作 者 对 使 用 项 目 或 代码 模板 的 
方法 并 不 热衷 。 提 供 这 种 模板 的 初 囊 是 好 的 ， 但 是 
只 拿 来 执行 总 觉得 平庸 。ASP.NET 和 MVC 的 特色 

之 一 就 是 在 定制 个 性 化 的 平台 时 有 非常 大 的 灵活 
性 。Visual Studio 创 建 和 填充 的 这 些 项 目 、 类 和 视 
Eaei e E a A 并 且 这 些 内 容 和 
配置 太 过 普通 ， 一 般 可 用 性 也 不 大 。 可 能 微软 也 不 
知道 用 户 需 sins en 所 以 他 们 做 的 是 
涵盖 所 有 的 基础 内 容 。 但 是 这 种 笼统 的 方式 反而 让 
作者 握 弃 这 些 默 认 的 内 容 。 


























建议 从 一 个 空 的 项 目 开 始 ， 添 加 需要 的 文件 
来、 文件 和 软件 包 ， 这 样 你 不 仪 可 以 了 解 MVC 的 工 


作 方 式 ， 还 可 以 完全 操控 应 用 程序 中 包含 的 所 有 内 


IP 


容 。 


当然 ， 作 者 的 偏好 不 应 该 完全 代表 你 的 开发 经 
验 ， 可 能 你 会 发 现 模板 更 好 用 ， 特 别 是 对 于 
ASP.NET 新 手 以 及 那些 还 没有 开发 适合 自己 的 开发 
样式 的 开发 者 来 说 。 你 可 能 还 会 觉得 项 目 模板 是 十 
分 有 用 的 资源 并 且 是 想法 的 来 源 ， 但 是 在 你 完全 了 
解 它 的 工作 方式 之 前 ， 你 应 该 谨慎 地 回应 用 程序 中 
添加 任何 功能 。 














3.4.1 创建 项 目 





当 首次 创建 新 的 ASP.NET 项 目 时 ， 可 以 从 以 下 
3 个 基本 的 起 点 一 一 Empty 模板 、Web API 模 板 和 
Web Application (Model-View-Controller) 模板 之 
一 开始 ， 如 图 3-5 所 示 。 


ting an ASP.NET Core 
application with exemple ASP.NET Core MVC Views and 
Controllers. This template can also be used for RESTful 
ices. 


Learn more 


























| Cancel 


图 3-5 ASP.NET 项 目 模板 


Empty 模板 包含 ASP.NET 的 内 核 管 道 ， 但 不 包 
括 MVC 项 目 所 需要 的 库 或 配置 。Web API 模 板 包含 
ASP.NET 内 核 和 MVC， 其 中 的 示例 应 用 程序 演示 
了 如 何 接收 和 处 理 来 自 客 户 端的 Ajax 请 求 ， 第 20 章 
将 对 此 进行 描述 。 


Web Application (Model-View-Controller) 模 
板 包括 ASP.NET Core 和 MVC， 其 中 包含 的 示例 应 
用 程序 演示 了 如 何 生 成 HTML 内 容 。Web API 和 


Web Application (Model-View-Controller) 模板 可 
以 提供 不 用 的 方案 来 为 用 户 配置 进行 身份 验证 和 授 
权 访 问 功能 。 





其 他 模板 提供 了 适合 使 用 单 页 应 用 程序 框 染 
CAngular 和 React) 与 Razor 页 面 的 初始 内 容 〈 人 允许 
代码 和 标记 混合 在 一 个 文件 中 ， 合 并 控制 占 和 视图 
的 角色 ， 并 权衡 MVC 模 型 的 一 些 优点 以 获得 简单 
HE) 。 








项 目 模 板 给 人 的 印象 可 能 是 你 需要 遵循 特定 的 
路 径 来 创建 特定 类 型 的 ASP.NET 应 用 程序 ， 但 情 
况 并 非 如 此 。 这 些 模板 只 是 在 完成 相同 功能 时 不 同 
的 起 点 。 在 使 用 任何 模板 创建 的 项 目 中 都 可 以 随时 
添加 需要 的 功能 。 例 如 ， 处 理 Ajax 请 求 ， 以 及 身份 
验证 和 授权 功能 都 是 从 空 的 项 目 模板 开始 的 。 











因此 ， 项 目 模板 之 间 的 真正 区 别 是 最 初 的 库 


R MALH, RI K Visual Studio 在 创建 项 目 
时 涿 加 的 内 容 。 最 简单 的 模板 和 最 复杂 的 模板 之 间 
存在 很 多 差异 ， 图 3-6 展示 了 每 种 模板 在 创建 新 的 
项 目 之 后 的 解决 方案 管理 器 (Solution Explorer) 的 
样子 。 对 于 Web Application (Model-View- 
Controller) 模板 ， 因 为 单个 列表 太 长 了 ， 所 以 必须 
将 解决 方案 管理 右 放 在 不 同 的 文件 夹 中 。 





使 用 Web Application (Model-View- 
Controller) 模板 还 加 到 项 目 中 的 额外 文件 看 起 来 令 
人 望 而 生 傅 ， 但 其 中 一 些 只 是 占 位 符 或 音 见 功能 的 
示例 实现 。 一 些 其 他 文件 设置 了 MVC 或 配置 了 
ASP.NET。 其 他 的 是 客户 闯 库 ， 你 将 在 程序 生成 
HTML 时 添加 这 些 库 。 现 在 的 文件 列表 看 起 来 可 能 
比较 长 ， 但 在 你 读 完 整 本 书后 ， 你 瓯 会 了 解 到 每 一 
个 文件 所 要 完成 的 功能 。 
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图 3-6 Empty 模板 和 Web Application (Model-View- 
Controller) 模板 添加 到 新 项 目 中 的 默认 内 容 


无 论 使 用 什么 模板 创建 项 目 ， 都 会 发 现 一 些 公 
用 的 文件 夹 和 文件 是 必然 出 现 的 。 项 目 中 的 某 些 项 
其 有 特殊 的 功能 ， 它 们 被 便 编码 到 ASP.NET 或 
MVC 中 ， 也 可 能 包含 在 Visual Studio 提 供 的 支持 工 
上 其中。 其 他 的 则 取决 于 大 多 数 ASP.NET 或 MVC 项 
目 使 用 的 命名 约定 。 表 3-1 描 述 了 ASP.NET Core 
MVC 项 目 中 一 些 重要 文件 来 ， 其 中 一 些 文件 夹 默 认 








情况 下 不 会 出 现 ， 这 会 在 稍 后 的 章节 中 介绍 。 


表 3-1 ”重要 的 文件 夹 


ule 
pome ee 


定义 视图 组 件 类 的 地 方 ， 这 些 类 用 来 显示 自 包 含 特征 例如 
/Components 
购物 车 ) 
| 用 来 放置 控制 器 类 的 地 方 ， 也 可 以 将 控制 器 类 放 在 任何 其 他 
ontrollers 
地 方 ， 它 们 都 会 被 编译 到 同一 个 程序 集中 























































































































这 是 定义 数据 库 相 关 类 的 地 方 ， 但 作者 更 习惯 在 Models 文 件 
ata 
中 对 它们 进行 定义 


这 里 存储 了 数据 库 架 构 的 详细 信息 ， 以 便 存 储 应 用 程序 的 数 
/Data/Migrations ， 在 第 8 一 11 章 中 ， 作 为 SportsStore 项 目的 一 部 分 ， 使 用 了 


迁移 


























用 来 存放 视图 模型 和 域 模型 类 ， 也 可 以 在 项 目的 任何 地 方 或 
另 一 个 单独 的 项 目 中 定义 模型 类 









































保存 视图 和 分 部 视图 ， 通 常 与 使 用 控制 器 命名 的 相关 文件 夹 
放 在 一 起 

















/Views 


























seco 


F 用 于 指定 Razor 视 图 中 的 命名 空间 ， 也 可 用 来 i 





















































/Views/_ViewImports.cshtml 




















/Views/_ViewStart.cshtml FE 用 于 指定 Razor 视 图 引擎 的 默认 布局 


这 是 放置 静态 内 容 〈 如 CSS 文 件 和 图 像 ) 的 地 方 ， 同 时 也 是 
Bower 包 管理 器 安装 JavaScript 和 CSS 软 件 包 的 地 方 








/wwwroot 

















下 面 列 出 一 些 重 要 的 文件 。 





e appsettings.json: 包含 可 适应 于 不 同 环境 《如 开 
有 发、 测试 、 生 产 环境 ) 的 配置 信息 。 该 文件 党 
用 于 数据 库 服务 器 连接 字符 串 和 日 志 / 调 试 配 
置 。 

。/bower.json: 默认 情况 下 ， 这 个 文件 是 隐藏 的 ， 
其 中 包含 了 由 Bower 软 件 包 管理 器 管理 的 文件 列 
Te 

e /<project>.csproj: 用 于 指定 项 目的 一 些 基 本 配 
置 选 项 ， 包 括 使 用 的 NuGet 属 性 。 

e /Program.cs: 负 贡 配置 应 用 程序 的 答 主 平台 。 








。/Startup.cs: 用 来 配置 应 用 程序 。 
3.4.2 ”关于 MVC 的 约定 


MVC 项 目 中 有 两 种 约定 。 其 中 一 种 是 关于 如 

何 构造 项 目的 建议 。 例 如 ， 按 和 章 规 将 依赖 的 第 三 方 
JavaScript 和 CSS 包 放 在 wwwroot/lib 文 件 夹 中 ， 其 他 
MVC 开 发 人 员 也 和 硕 望 在 这 里 能 找到 这 些 包 ， 软 件 包 
管理 器 也 会 默认 将 这 些 包 安装 在 这 里 。 当 然 ， 你 也 
可 以 随意 重 命名 或 删除 lb 文件 夹 ， 或 者 把 软件 包 放 
到 其 他 地 方 。 只 要 视图 中 的 脚本 和 链接 元 素 指 网 的 
位 置 正 确 ，MVC 束 可 以 正常 地 运行 应 用 程序 。 














万 一 种 约定 源 于 配置 方面 的 原则 ， 这 也 是 Ruby 
on Rails 如 此 有 党 欢迎 的 原因 之 一 。 通 过 配置 ， 不 需 
要 时 了 地 配置 控制 硕 与 视图 之 间 的 关联 。 例 如 ， 只 
需要 巡 循 特定 的 文件 命名 规则 束 可 以 使 程序 正常 执 
行 。 在 此 约定 下 ， 更 改 项 目 结构 的 灵活 性 就 变 得 很 





cr 
提 示 
如 果 将 标准 的 MVC 组 件 蔡 换 为 自己 的 实现 ， 
所 有 这 些 约定 就 可 以 改变 了 。 本 书 将 介绍 不 同 的 广 


法 ， 以 帮助 我 们 解释 MVC 应 用 程序 是 如 何 工作 的 ， 
这 些 是 你 在 大 多 数 项 目 中 会 磁 到 的 约定 。 





1. 关于 控制 费 类 的 约定 


控制 器 类 的 名 称 都 是 以 Controller 结 尾 的 ， 例 如 


ProductController、AdminController 和 和 


HomeController。 当 从 项 目的 其 他 位 置 引 用 控制 磊 
时 ， 如 使 用 HTML 辅 助 方法 时 ， 只 需要 指定 名 称 的 
第 一 部 分 〈 如 Product) ，MVC 束 会 目 动 将 
Controller 奶 加 到 名 称 中 ， 并 开始 查找 控制 右 类 。 





q 
提 示 


可 以 通过 创建 模型 约定 来 改变 这 一 点 ， 详 见 第 
Sit. 


2. 关于 视图 的 约定 


视图 保存 在 /Views/Controllername 文 件 夹 中 。 


例如 ， 与 ProductController 类 关联 的 视图 将 保存 
在 /Views/ Product 文 件 夹 中 。 


q 
提 示 


请 注意 ， 这 里 在 Views 文 件 夹 中 省 略 了 控制 器 
类 的 Controller 部 分 ， 比 如 使 用 的 是 /Views/Product 
而 不 是 Views/ProductController。 


MVC 升 望 操作 方法 的 默认 视图 应 以 操作 方法 
命名 。 例 如 ， 与 列表 List) 操作 方法 相关 联 的 默 
认 视 图 应 名 为 List.cshtml。 因 此 ， 对 于 
ProductController 类 中 的 列表 (List〉 操作 方法 ， 默 





认 视 图 应 该 是 /Views/ Product/List.cshtml。 当 你 在 操 
作 方 法 中 返回 调用 View 方 法 的 结果 时 ， 将 使 用 默认 
视图 ， 如 下 所 示 : 


return View(); 


BIG A PAE ALA, SOR Ars: 


return View("MyOtherView" ) ; 








atm, EPA A Te CTT EA 
或 视图 路 径 。 在 得 找 视图 时 ，MVC 首 先 会 在 以 控制 
air tid 4 I CPPS ER, YA Ja TE/Views/Shared x 
夹 中 租 找 。 这 意味 着 可 以 将 多 个 控制 器 使 用 的 视图 
放 在 /Views/Shared 文 件 夹 中 ，MVC 可 以 找到 它们 。 





3. 天 于 布局 的 约定 





布局 的 命名 约定 古 在 文件 中 加 上 下 划 线 (_) 
字符 ， 布 局 文件 放 在 /Views/Shared 文 件 夹 中 。 默 认 
情况 下 ， 所 有 视图 都 会 使 
用 /Views/_ViewStart.cshtml 文件 。 如 果 不 想 将 默认 
版 式 应 用 于 视图 ， 可 以 更 改 _ViewStart.cshtml 中 的 
设置 (或 完全 删除 该 文件 ) 并 在 视图 中 指定 其 他 版 
式 ， 如 下 所 示 : 











@{ 
Layout = "~/ MyLayout.cshtml"; 
} 
也 可 以 对 给 定 视 图 禁用 任何 布局 ， 如 下 所 示 : 
@{ 
Layout = null; 
} 


3.5 ”小 结 


本 章 首 先 介 绍 了 人 MVC 架构 模式 ， 人 然后 讨论 了 


领域 模型 的 意义 ， 并 讲述 了 依赖 注入 。 依 赖 注入 能 
够 消除 组 件 耘 合 ， 以 强制 应 用 程序 各 部 件 之 间 严 格 
分 离 。 下 一 章 将 介绍 C# 语 言 特性 ， 它 们 已 广泛 应 用 
于 MVC Web 应 用 开发 中 。 


第 4 章 ”C# 基 本 特性 


本 章 主要 描述 在 Web 应 用 开 及 中 难 理解 或 经 冰 
引起 混 洒 的 C# 特 性 。 因 为 这 不 是 专门 介绍 C# 的 
书 ， 所 以 对 于 每 个 C# 特 性 ， 本 书 只 提供 条 单 的 示 
例 ， 以 便 读 者 在 后 续 的 章节 中 能 够 更 清楚 地 了 解 示 
例 ， 并 在 目 己 的 项 目 中 充分 利用 这 些 特性 。 











表 4-1 列 出 了 本 章 要 解决 的 问题 。 


表 4-1 本 章 要 解决 的 问题 


null fF EEA 4-5 一 代码 清 





















































避免 访问 空 的 属性 






































自动 实现 的 属 4-9 一 代码 清 
































简化 C# 属 性 



































简化 字符 串 组 合 使 用 字符 串 插值 。 | 代码 清单 4-12 





























代码 清单 4-13 一 代码 清 
单 4-16 























测试 对 象 的 类 型 或 特征 j 模 式 匹 配 



































j 对 象 或 集合 初 | 代码 清单 4-17 和 代码 清 
单 4-18 





























一 次 性 创建 对 象 并 设 





















































代码 清单 4-19 一 代码 清 
单 4-26 


























为 不 能 修改 的 类 添加 功能 j 扩 展 方法 























代码 清单 4-27~- 代 码 清 
单 4-34 
































简化 委托 和 声明 方法 的 使 月 jLambda 表 达 式 


















































jvar 关 键 字 代码 清单 4-35 











代码 清单 4-36 和 代码 清 
4-37 









































创建 对 象 而 不 定义 其 类 型 j 匿 名 方法 






































jasync 和 await 关 | 代码 清单 4-38 一 代码 清 














简化 异步 方法 的 使 用 














单 4-41 











在 不 定义 静态 字符 串 的 情况 下 获取 类 方法 或 EEN 代码 清单 4-42 和 代码 清 
jnameof 表 达 式 


属性 的 名 称 单 4-43 




































































4.1 准备 示例 项 日 





在 本 章 中 ， 为 了 演示 语言 特性 ， 使 用 ASP.NET 


MVC Core Web Application (.NET Core) 模板 创建 
了 一 个 新 的 Visual Studio 项 目 ， 并 命名 为 
LanguageFeatures， 如 图 4-1 所 示 ， 取 消 勺 选 Add to 
Source Control 复 选 枉 ， 单 击 OK 按钮 。 





LanguageFeatures 











图 4-1 选择 项 目 类 型 





当 需 要 呈现 不 同 的 项 目 配置 时 ， 可 以 选择 
Empty 模 板 ， 如 图 4-2 所 示 。 在 对 话 框 项 部 的 列表 中 
选择 .NET Core 和 ASP.NET Core 2.0， 确 保 将 
Authentication 选 项 设置 为 No Authentication， 并 在 
单 击 OK 按钮 创建 项 目 之 前 ， 取 消 选 中 Enable 
Docker Support 复 选 框 。 








cation - Languag 
ASP.NET Core2.0 
empty project templ: SP. 
ion. Thi 
‘eo a aog 
Web Web gular Leam more 
Application Application 
(Model-View- 
ontroller ) 
& 
React.js and 
Redux 
cation 
en No Authentication 
C Enable 
Requi k r Windows 
Docker support can also be enabled later Learn mor 
Cancel 











图 4-2 ”选择 项 目 模 板 
4.1.1 启用 ASP.NET Core MVC 


使 用 Empty 项 目 模板 创建 的 项 目 中 包含 最 小 的 
ASP.NET 核 心 配置 ， 并 且 没 有 提供 任何 MVC 文 
持 ， 这 就 意味 着 Web Application (Model-View- 
Controller) 模板 深 加 的 占 位 内 容 尚 不 存在 ， 要 使 控 
制 工 和 视 图 起 作用 ， 还 需要 执行 一 些 额 外 的 操作 步 
又 。 本 贡 虽 然 介 绍 了 局 用 MVC 设 置 所 需要 的 步骤 ， 
但 不 会 深入 齐 析 每 一 个 步骤 的 细 古 。 


要 启用 MVC 框 架 ， 请 对 Startup 类 进行 代码 清单 
4-1 所 示 的 更 改 。 


代码 清单 4-1 ”在 LanguageFeatures 文 件 夹 下 的 Startup.cs 文 件 中 


启用 MVC 框 架 





using 
using 
using 
using 
using 
using 
using 
using 


System; 

System.Collections.Generic; 

System. Ling; 

System. Threading.Tasks; 
Microsoft.AspNetCore. Builder; 
Microsoft.AspNetCore.Hosting; 
Microsoft.AspNetCore.Http; 
Microsoft.Extensions.DependencyInjection; 


namespace LanguageFeatures { 


public class Startup { 


public void ConfigureServices(IServiceCollectio 


n services) { 


services.AddMvc(); 


public void Configure(IApplicationBuilder app, 


IHostingEnvironment env) { 


if (env.IsDevelopment()) { 
app .UseDeveloperExceptionPage() ; 


i 


//app.Run(async (context) => { 


// await context.Response.WriteAsync("He 
llo World!"); 
/1})3 


app.UseMvcWithDefaultRoute() ; 





本 书 第 14 章 将 介绍 怎样 配置 ASP.NET Core 
MVC 应 用 程序 ， 但 代码 清单 4-1 中 额外 添加 的 两 个 
语句 使 得 应 用 程序 具有 基本 的 MVC 设 置 并 使 用 默认 
的 配置 和 约定 。 














4.1.2 ”创建 MVC 应 用 程序 组 件 


MVC 设 置 好 了 之 后 ， 我 们 便 可 以 添加 MVC 应 
用 程序 组 件 来 演示 重要 的 C# 语 言 特性 。 


1. 创建 模型 


我 们 从 创建 一 个 简单 的 模型 类 开始 ， 接 下 来 驶 
可 以 使 用 一 些 模型 数据 了 。 添 加 一 个 名 为 Models 的 





文件 夹 并 在 其 中 创建 一 个 文件 ， 命 名 为 Product.cs 以 
定义 代码 清单 42 中 的 类。 


代码 清单 4-2 Models 文 件 夹 下 的 Product.cs 文 件 的 内 容 


namespace LanguageFeatures.Models { 
public class Product { 


public string Name { get; set; } 
public decimal? Price { get; set; } 


public static Product[] GetProducts() { 


Product kayak = new Product { 
Name = "Kayak", Price = 275M 
}; 


Product lifejacket = new Product { 
Name = "Lifejacket", Price = 48.95M 


}; 


return new Product[] { kayak, lifejacket, n 





Products 类 定义 了 Name 和 Price 属 性 ， 还 有 一 个 
名 为 GetProducts 的 静态 方法 用 于 返回 Products 数 


组 。 这 个 数组 中 的 一 个 元 系 已 设置 为 null， 用 来 展 
示 一 些 有 用 的 C# 特 性 。 


2. 创建 控制 费 和 视图 





对 于 本 章 中 的 示例 ， 我 们 使 用 一 个 简单 的 控制 
露 来 演示 不 同 的 C# 语 言 特 性 。 创 建 Controllers 文 件 
夹 并 在 其 中 添加 HomeController.cs 类 文件 ， 其 中 的 
内 容 如 代码 清单 4-3 所 示 。 如 果 使 用 默认 的 MVC 配 
置 ，MVC 会 默认 把 HTTP 请 求 发 送 到 Home 控 制 器 。 


代码 清单 4-3 ”Controllers 文 件 夹 下 的 HomeController.cs 文 件 的 
内 容 





using Microsoft.AspNetCore.Mvc; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 
return View(new string[] { "C#", "Language" 
» "Features" }); 
} 
} 


Pe 


Index 操 作 方法 使 得 MVC 呈 现 默认 视图 并 且 在 
HTML 中 传递 一 个 字符 冲 数 组 给 客户 疹 。 为 了 创建 
相应 的 视图 ， 添 加 Views/Home 文 件 夹 (首先 创建 
Views 文 件 夹 ， 然 后 在 其 中 创建 Home 子 文件 夹 ) ， 
再 在 其 中 创建 Index.cshtml 文 件 ， 这 个 文件 的 内 容 如 
代码 清单 4-4 所 示 。 








代码 清早 4-4 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 的 内 容 





@model IEnumerable<string> 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 

<meta name="viewport" content="width=device-width" 
/> 

<title>Language Features</title> 
</head> 
<body> 

<ul> 

@foreach (string s in Model) { 
<li>@s</li> 


</ul> 


</body> 
</html> 

MA Debug 2.644% Start Debugging 以 运行 示例 
应 用 程序 ， 你 会 看 到 网 4-3 所 示 的 输出 。 








图 4-3 ”运行 示例 应 用 程序 


由 于 本 章 中 所 有 示例 的 输出 都 是 文本 ， 因 此 浏 
响 硕 中 显示 的 信息 可 如 下 呈现 : 


C# 
Language 
Features 


42 ”运用 null 条 件 运 算 符 


null 条 件 运 算 符 可 以 使 我 们 更 优雅 地 判断 null 
值 。 在 MVC 开 发 中 ， 我 们 需要 判断 请 求 是 否 包 含 尖 





部 或 值 ， 还 需要 判断 模型 中 是 否 包含 特殊 的 数据 
项 ， 因 此 会 有 大 量 的 null 值 需要 检测 。 处 理 null 值 的 
传统 方式 是 进行 显 式 检测 ， 但 是 当 对 象 及 其 属性 都 
需要 检查 时 ， 这 种 方式 就 变 得 见长 且 容 易 出 错 ， 
null 条 件 运 算 符 使 这 一 过 程 变 得 更 加 简洁 明了 ， 如 
代码 清单 4-5 所 示 。 











代码 清单 4-5” 在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 检测 null 值 





using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 
List<string> results = new List<string>(); 


foreach (Product p in Product.GetProducts() 
) { 
string name = p?.Name; 
decimal? price = p?.Price; 
results.Add(string.Format("Name: {0}, P 
rice: {1}", name, price)); 


} 


return View(results) ; 





Product 类 定义 的 GetProducts 静 态 方法 会 返回 一 
个 对 象 数组 。 在 控制 器 的 Index 操 作 方 法 中 对 这 些 值 
进行 检查 以 获得 Name 和 Price 值 的 列表 。 问 题 是 返 
回 的 对 象 以 及 对 象 中 属性 的 值 都 有 可 能 为 null。 也 
残 是 说 ， 不 能 在 for 循 环 中 仅仅 通过 p.Name 或 p.Price 
来 引用 值 ， 人 否则 会 导致 NullReferenceException。 为 
了 避免 这 一 点 ， 可 使 用 null 条 件 运 算 符 ， 如 下 上 所 
7N: 








string name = p?.Name; 


decimal? price = p?.Price; 





null 条 件 运 算 符 是 一 个 问号 《〈 符 号? ) 。 如 果 p 
为 null，name 也 将 设置 为 null; 如 果 p 不 为 null， 


name 将 设置 为 Person.Name 属 性 的 值 。 同 样 ，Price 
属性 也 是 如 此 。 请 注意 ， 在 使 用 null 条 件 运 算 符 

时 ， 指 派 的 变量 必须 能 够 为 hull， 这 就 是 为 什么 将 
price 变 量 声明 为 可 以 为 null 的 十 进 制 数值 。 


4.2.1 _ null 条 件 运算 符 的 连接 运算 


null 条 件 运 算 符 可 以 连 在 一 起 以 志 历 整个 对 象 
的 层次 结构 ， 这 使 它 成 为 催化 代码 ddl 
航 的 有 效 工具 。 在 代码 清单 4-6 中 ， 在 授 套 引用 的 
Product 类 中 添加 一 个 属性 ， 创 建 更 加 复杂 的 对 象 层 
次 结构 。 





代码 清单 4-6 ”在 Models 文 件 夹 下 的 Product.cs 文 件 中 添加 一 个 
属性 





namespace LanguageFeatures.Models { 
public class Product { 


public string Name { get; set; } 
public decimal? Price { get; set; } 
public Product Related { get; set; } 


public static Product[] GetProducts() { 


Product kayak = new Product { 
Name = "Kayak", Price = 275M 
}; 
Product lifejacket = new Product { 
Name = "Lifejacket", Price = 48.95M 
}; 


kayak.Related = lifejacket; 


return new Product[] { kayak, lifejacket, n 





每 一 个 Product 对 象 都 有 一 个 可 以 引用 其 他 
Product 对 象 的 Related 属 性 。 在 GetProducts 方 法 中 ， 
设置 代表 皮 艇 的 Product 对 象 的 Related 属 性 。 代 码 清 
单 4-7 展 示 了 如 何 利用 null 条 件 运算 符 检 验 对 象 属性 
但 不 引起 错误 。 


代码 清单 4-7 检测 在 Controllers 文 件 夹 下 的 HomeController.cs 
LFF RE Knulla 


using Microsoft.AspNetCore.Mvc; 


using System.Collections.Generic; 
using LanguageFeatures.Models; 


namespace LanguageFeatures.Controllers { 


public class HomeController : Controller { 


public ViewResult Index() { 


List<string> results = new List<string>(); 


foreach (Product p in Product.GetProducts() 
) { 


string name = p?.Name; 
decimal? price = p?.Price; 


string relatedName = p?.Related?.Name; 


results.Add(string.Format("Name: {0}, P 
rice: {1}, Related: {2}", 


name, price, relatedName)); 


} 


return View(results); 








null 条 件 运 算 符 可 以 家 应 用 于 属性 链 中 的 任意 
Bad, WA PF IRAE: 


string relatedName = 


= p?.Related?.Name; 





UE FH EIS EEA: 当 p 为 null 或 者 p.Related 为 
null 时 ，relatedName 为 null; 人 否则，relatedName 为 
p.Related.Name 属 性 的 值 。 运 行程 序 ， 你 将 在 浏览 
器 窗口 中 看 到 如 下 和 输出: 


Name: Kayak, Price: 275, Related: Lifejacket 
Name: Lifejacket, Price: 48.95, Related: 


Name: , Price: , Related: 





4.2.2 ”联合 使 用 null 条 件 运 算 符 和 null 合 并 运算 符 

通过 将 null 条 件 运 算 符 〈 单 个 问 亏 ) 和 null 合 并 
运算 符 ( 两 个 问号 ) 联合 起 来 使 用 ， 可 以 有 效 地 将 
null 值 反馈 给 应 用 程序 ， 如 代码 清单 4-8 所 示 。 


代码 清单 4-8 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 结合 使 用 null 条 件 运算 符 和 null 合 并 运算 符 








using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 
List<string> results = new List<string>(); 


foreach (Product p in Product.GetProducts() 
) 1{ 
string name = p?.Name ?? "<No Name>"; 
decimal? price = p?.Price ?? Q; 
string relatedName = p?.Related?.Name ? 
? "<None>"; 
results.Add(string.Format("Name: {0}, P 
rice: {1}, Related: {2}", 
name, price, relatedName)); 


J 


return View(results); 





null 条 件 运 算 符 可 以 保证 在 使 用 对 象 属 性 的 过 
程 中 不 会 抛 出 NullReferenceException 异 常 ， 而 null 
合并 运算 符 可 以 保证 在 浏览 夯 的 显示 结 末 中 不 包含 
nul 值 。 运 行程 序 ， 你 将 看 到 浏览 右 窗 口中 显示 如 
下 结果 : 


Name: Kayak, Price: 275, Related: Lifejacket 
Name: Lifejacket, Price: 48.95, Related: <None> 





Name: <No Name>, Price: ©, Related: <None> 


4.3 使 用 目 动 实现 属性 








C# 文 持 目 动 实现 属性 ， 我 们 之 前 在 定义 Person 
类 的 属性 时 使 用 过 这 项 功能 ， 如 下 所 示 : 
namespace LanguageFeatures.Models { 
public class Product { 
public string Name { get; set; } 


public decimal? Price { get; set; } 
public Product Related { get; set; } 


public static Product[] GetProducts() { 


Product kayak = new Product { 
Name = "Kayak", Price = 275M 
}; 
Product lifejacket = new Product { 
Name = "Lifejacket", Price = 48.95M 


}; 
kayak.Related = lifejacket; 


return new Product[] { kayak, lifejacket, n 








这 项 功能 使 我 们 可 以 在 定义 属性 的 时 候 不 必 实 





现 get 和 set 主 体 。 使 用 目 动 实现 属性 让 我 们 可 以 像 





如 下 示例 这 样 定义 属性 : 





public string Name { get; set; } 
以 上 代码 等 效 于 以 下 代码 : 


public string Name { 
get { return name; } 
set { name = value; } 





} 


这 种 语法 特征 称 为 语法 糖 (syntactic sugar) ， 
这 使 得 C# 的 使 用 变 得 更 加 友好 。 在 本 例 中 ， 你 可 以 
通过 为 赋值 属性 消除 元 余 代 码 而 无 须 大 规模 地 修改 
代码 的 运行 巡 辑 。 任 何 可 以 使 代码 变 得 更 加 易于 编 
写 和 维护 的 优化 都 是 有 益 的， 特别 是 在 大 型 项 目 
中 。 








4.3.1 ”初始 化 目 动 实现 的 属性 


自动 实现 的 属性 在 C# 3.0 以 上 的 版 本 中 都 支 
持 ， 可 以 在 不 需要 构造 函数 的 情况 下 设置 初始 值 ， 
如 代码 清单 4-9 所 示 。 


代码 清单 49 ”在 Models 文 件 夹 下 的 Product.cs 文 件 中 初始 化 自 
动 实现 的 属性 





namespace LanguageFeatures.Models { 
public class Product { 


public string Name { get; set; } 

public string Category { get; set; } = "Watersp 
orts"; 

public decimal? Price { get; set; } 

public Product Related { get; set; } 


public static Product[] GetProducts() { 
Product kayak = new Product { 
Name = "Kayak", 
Category = "Water Craft", 
Price = 275M 
}; 
Product lifejacket = new Product { 
Name = "Lifejacket", Price = 48.95M 


ie 


kayak.Related = lifejacket; 


return new Product[] { kayak, lifejacket, n 





为 自动 实现 的 属性 赋值 并 不 会 阻止 后 续 的 setter 
方法 对 属性 值 进行 改变 ， 但 是 在 需要 使 用 构造 函数 
为 大 量 默 认 属 性 赋值 的 情况 下 ， 可 以 让 代码 更 加 位 
洁 。 代 人 码 清 单 4-9 已 将 Water Craft 赋 给 Category 属 
性 ， 并 且 初 始 值 是 可 以 更 改 的 。 











4.3.2 ”创建 只 读 的 目 动 实现 属性 


我 们 还 可 以 创建 只 读 属性 ， 在 初始 化 目 动 实现 
的 属性 时 忽略 set 关键 字 即 可 实现 这 一 点 ， 如 代码 
清单 4-10 所 示 。 





代码 清单 4-10 在 Models 文 件 夹 下 的 Product.cs 文 件 中 创建 只 恋 
的 自动 实现 属性 


namespace LanguageFeatures.Models { 





public class Product { 


public string Name { get; set; } 

public string Category { get; set; } = "Watersp 
orts"; 

public decimal? Price { get; set; } 

public Product Related { get; set; } 

public bool InStock { get; } = true; 


public static Product[] GetProducts() { 


Product kayak = new Product { 
Name = "Kayak", 
Category = "Water Craft", 
Price = 275M 
}; 
Product lifejacket = new Product { 
Name = "Lifejacket", Price = 48.95M 


] 


kayak.Related = lifejacket; 


return new Product[] { kayak, lifejacket, n 








InStock 属 性 被 初始 化 为 true 并 且 不 能 更 改 ， 但 
是 可 以 在 类 的 构造 函数 中 进行 赋值 ， 如 代码 清单 4- 
11 所 示 。 


代码 清单 4-11 在 Models 文 件 夹 下 的 Product.cs 文 件 中 为 只 读 的 
自动 实现 属性 赋值 








namespace LanguageFeatures.Models { 
public class Product { 


public Product(bool stock = true) { 
InStock = stock; 


} 


public string Name { get; set; } 
public string Category { get; set; } = "Watersp 
orts"; 
public decimal? Price { get; set; } 
public Product Related { get; set; } 
public bool InStock { get; } 
public static Product[] GetProducts() { 
Product kayak = new Product { 

Name = "Kayak", 

Category = "Water Craft", 

Price = 275M 


】 
Product lifejacket = new Product(false) { 
Name = "Lifejacket", 


Price = 48.95M 
}3 


kayak.Related = lifejacket; 


return new Product[] { kayak, lifejacket, n 


构造 函数 允许 将 只 读 属 性 的 值 指 定 为 参数 ， 如 
果 没 有 提供 值 ， 默 认为 true。 在 使 用 构造 函数 设置 
之 后 ， 属 性 值 束 无 法 更 改 了 。 





4.4 使 用 字符 串 搬 值 


string.Format 方 法 是 构造 包含 数据 值 的 字符 串 
的 传统 C# 工 具 。 如 下 是 Home 控 制 器 中 的 一 个 示 
例 : 


results.Add(string.Format("Name: {0}, Price: {1}, Relat 


ed: {2}", 
name, price, relatedName) ) ; 











CH 6.08 UN T I ab TT OBR AEE E Ti 
值 ) WISE, ROPE ICME SEE AB RA HAH {0} 9 
用 必须 与 参数 变量 匹配 。 字 符 串 插值 下 接 使 用 变量 








名 束 可 以 了 ， 如 代码 消 单 4-12 所 示 。 


代码 清单 4-12 ”在 Controller 文 件 夹 下 的 HomeController.cs 文 件 
中 使 用 字符 串 插值 
using Microsoft.AspNetCore.Mvc; 


using System.Collections.Generic; 
using LanguageFeatures.Models; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 
List<string> results = new List<string>(); 
foreach (Product p in Product.GetProducts() 


string name = p?.Name ?? “<No Name>"; 

decimal? price = p?.Price ?? 0; 

string relatedName = p?.Related?.Name ? 
? "<None>"; 

results.Add($"Name: {name}, Price: {pri 
ce}, Related: {relatedName}") ; 


} 


return View(results); 





插值 字符 串 以 $ 作 为 前 缀 并 且 包 含 槽 hole) ， 
这 是 对 包含 在 {and} 字 符 内 的 值 的 引用 。 计 算 字 符 
串 时 ， 可 利用 指定 的 变量 或 癌 量 来 填 序 这些 档 。 





Visual Studio 提 供 了 用 于 创建 插值 字符 串 的 知 
能 感知 文 持 ， 当 键入 { 符 号 时 ， 提 供 了 可 用 方法 的 
列表 ; 这 束 最 大 限度 减少 了 和 人 为 的 输入 错误 ， 并 且 
结果 的 字符 串 格 式 更 易 理解 。 


he ZR 
字符 串 插 值 支持 string.Format 方 法 可 用 的 所 有 
指定 格式 。 格 式 说 明 符 是 槽 的 一 部 分 ， 因 此 $"Price: 


{price:C2} 将 把 price 值 格式 化 为 带 两 位 小 数 的 贷 
值 。 


4.5 使 用 对 象 和 集合 初始 化 器 





当 在 Product 类 的 静态 方法 GetProducts 中 创建 一 
个 对 象 时 ， 使 用 对 象 初始 化 器 可 以 实现 创建 对 象 和 
初始 化 属性 值 一 步 完 成 ， 如 下 所 示 : 


Product kayak = new Product { 
Name = "Kayak", 


Category = "Water Craft", 
Price = 275M 





}3 


这 是 可 以 使 C# 语 言 易 于 使 用 的 力 一 个 语法 糖 特 
征 。 没 有 这 个 功能 ， 我 们 束 不 得 不 调用 Product 构 造 
图 数 ， 然 后 使 用 新 创建 的 对 象 来 设置 每 个 属性 的 
值 ， 像 下 面 这 样 : 





Product kayak = new Product(); 
kayak.Name = "Kayak"; 


kayak.Category = "Water Craft"; 
kayak.Price = 275M; 





ZUNE A aoa, PAE AY ASB 
建 集合 和 初始 化 集合 内 容 一 步 完 成 。 例 如 ， 创 建 一 
个 字 答 数组， 如果 没 有 初始 化 莫 ， 将 圾 要 指定 数组 
的 大 小 以 及 每 一 个 数组 元 素 的 值 ， 如 代码 清单 4-13 
所 示 。 


代码 清单 4-13 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 初始 化 一 个 对 象 





using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 
string[] names = new string[3]; 


names[@] = "Bob"; 
names[1] = "Joe"; 
names[2] = "Alice"; 


return View("Index", names); 


il 

使 用 初始 化 如 可 以 使 设 定数 组 元 素 的 值 成 为 所 
构造 集合 的 一 部 分 ， 这 种 结构 隐 式 地 为 编译 器 提供 
了 数组 的 大 小 ， 如 代码 清单 4-14 所 示 。 








代码 清单 4-14 在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 使 用 初始 化 器 





using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 
return View("Index", new string[] { "Bob", 
"Joe", "Alice" }); 


} 








BAA TCR ME SEP RUZ IA, ERR 
HY ne SC BEIM fis} HE ALY PA SE BLS EY REEN., TU 
码 清 单 4-14 中 的 代码 与 代码 清单 4-13 中 的 代码 有 相 








SCR, WRI ATA PIM ARE, VRE CED bt as 
窗口 中 看 到 如 下 内 容 : 


Bob 
Joe 
Alice 


(EHR S| Sa tas 


C# 梳 理 了 集合 初始 化 占 的 用 法 ， 可 使 用 索引 来 
创建 字典 这 样 的 集合 。 代 码 清早 4-15 展 示 了 如 何 通 
过 传统 的 C# 方 式 重 写 Index 操 作 方 法 来 初始 化 一 个 
字典 


ŽNO 








代码 清单 4-15 “在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 初始 化 一 个 字典 





using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 


Dictionary<string, Product> products = new 
Dictionary<string, Product> { 


{ "Kayak", new Product { Name = "Kayak" 
» Price = 275M } }, 


{ "Lifejacket", new Product{ Name = "Li 
fejacket", Price = 48.95M } } 


3 
return View( "Index", products .Keys); 





初始 化 此 类 集合 的 语法 过 于 依赖 < 人 2 和 ”“}” 了 ， 
尤其 是 在 利用 对 象 初始 化 颖 来 定义 集合 值 的 时 候 。 
C# 编 详 融 文 持 使 用 一 种 更 加 目 然 的 方法 来 初始 化 索 
引 集合 ， 这 种 方法 与 在 初始 化 集合 后 检索 或 更 改 值 
征 一 致 的 ， 如 代码 清单 4-16 所 示 。 














代码 清单 4-16 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 使 用 C# 和 集合 初始 化 器 语法 





using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 
Dictionary<string, Product> products = new 
Dictionary<string, Product> { 
["Kayak"] = new Product { Name = "Kayak 
", Price = 275M }, 
["Lifejacket"] = new Product { Name = " 
Lifejacket", Price = 48.95M } 
}; 


return View("Index", products.Keys) ; 











以 上 操作 的 效果 等 同 于 创建 一 个 字典 ， 键 为 
Kayak 和 Lifejacket， 值 为 Product 对 象 ， 但 元 素 是 通 
过 用 于 其 他 集合 操作 的 索引 表示 法 创建 的 。 如 果 运 
行 示例 应 用 程序 ， 在 浏览 右 窗 口中 将 可 以 看 到 如 下 
结 来 : 


Kayak 
Lifejacket 


4.6 ”模式 匹配 





最 近 对 C# 最 有 用 的 补充 之 一 是 对 模式 匹配 的 文 





持 ， 模 式 匹 配 可 用 于 测试 对 象 是 特定 类 型 的 还 是 具 
有 特定 特征 。 为 一 种 形式 是 语法 糖 ， 它 可 以 极 大 地 
简化 复杂 的 条 件 语句 块 。is 关 键 字 用 于 执行 类 型 测 
试 ， 如 代码 消音 4-17 所 示 。 


代码 清单 4-17 ”对 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
执行 类 型 测试 





using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 
object[] data = new object[] { 275M, 29.95M, 


"apple", "orange", 100, 10 }; 
decimal total = Q; 
for (int i = 0; i < data.Length; i++) { 
if (data[i] is decimal d) { 
total += d; 
} 
} 


return View("Index", new string[] { $"Total 
: {total:c2}" }); 





is 关键 字 执行 类 型 检查 ， 如 条 值 是 指定 的 类 
Hl, URES He ae, ER Aas: 


if (data[i] is decimal d) { 


dn Rdatali] FAN <e PEA, ASA Ea 
达 式 的 计算 结果 将 为 tue。data[ 站 的 值 将 被 分 配给 变 
量 d， 这 样 就 可 以 在 随后 的 语句 中 使 用 该 值 ， 而 无 
须 执 行 任何 类 型 转换 。is 关 键 字 将 只 [匹配 指定 的 类 
型 ， 这 意味 看 只 处 理 data 数 组 中 的 两 个 值 〈 数 组 中 
的 其 他 元 素 是 string 和 int 值 ) 。 


如 果 运 行 应 用 程序 ， 浏 览 句 窗口 会 显示 以 下 输 
出 : 


Total: $304.95 


switch 语 句 中 的 模式 匹配 


模式 匹配 也 可 以 在 switch 语 句 中 使 用 ，switch 语 
句 文 持 when 关 键 字 ， 用 于 在 case 语 句 匹 配 值 时 进行 
限制 ， 如 代码 清单 4-18 所 示 。 


代码 清单 4-18 ”Controllers 文 件 夹 下 的 HomeController.cs 文 件 中 
的 模式 匹配 





using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 
object[ ] data = new object[] { 275M, 29.95M 


"apple", "orange", 100, 10 }; 
decimal total = Q; 
for (int i = 0; i < data.Length; i++) { 
Switch (data[i]) { 
case decimal decimalValue: 
total += decimalValue; 
break; 
case int intValue when intValue > 5 


total += intValue; 
break; 


} 


return View("Index", new string[] { $"Total 
: {total:C2}" }); 
} 


} 





要 匹配 特定 类 型 的 任何 值 ， 请 在 case 语 句 中 使 
用 类 型 和 变量 名 ， 如 下 所 示 : 


case decimal decimalValue: 


以 上 case 语 句 能 匹配 任何 十 进 制 值 ， 并 将 其 赋 
给 名 为 decimalValue 的 新 变量 。 


为 了 更 有 选择 性 ， 可 以 包含 when 关 键 字 ， 如 下 
所 示 : 


case int intValue when intValue > 50: 


以 上 case 语 句 能 匹配 int 值 ， 并 将 它们 赋 给 名 为 
intValue 的 变量 ， 但 仅 当 值 大 于 50 时 才 这 么 做 。 如 
果 运 行 应 用 程序 ， 浏 览 器 窗口 会 显示 以 下 输出 : 


4.7 ”使 用 扩展 方法 

















扩展 方法 是 在 类 中 添加 不 属于 用 户 且 不 能 直接 
修改 的 方法 的 简便 方式 。 代 码 清单 4-19 展 示 了 
ShoppingCart 类 的 定义 ， 将 它 添 加 到 Models 文 件 夹 
的 ShoppingCart.cs 文 件 中 ， 用 于 表示 Product 对 象 的 


EA 
Ho 


代码 清单 4-19 Models 文 件 夹 下 的 ShoppingCart.cs 文 件 的 内 容 





using System.Collections.Generic; 


namespace LanguageFeatures.Models { 


public class ShoppingCart { 
public IEnumerable<Product> Products { get; set 


F 


这 个 简单 的 类 可 作为 Product 对 象 列 表 的 封装 器 
(对 于 本 例 我 们 只 需要 一 个 基础 类 ) 。 假 设 我 们 需 
要 定义 ShoppingCart 类 中 Product 对 象 的 总 值 ， 但 是 
不 能 改变 类 本 里 ， 由 于 它 来 日 第 三 方 ， 因 此 我 们 可 
能 无 法 获取 源 代码 。 这 时 候 我 们 束 可 以 使 用 扩展 方 
法 来 添加 我 们 需要 的 功能 。 代 人 码 清 单 4-20 展 示 了 添 
加 到 Models 文 件 夹 中 的 MyExtensionMethods 类 。 





代码 清单 4-20 Models 文 件 夹 下 的 MyExtensionMethods.cs 文 件 
的 内 容 





namespace LanguageFeatures.Models { 


public static class MyExtensionMethods { 


public static decimal TotalPrices(this Shopping 
Cart cartParam) { 
decimal total = Q; 
foreach (Product prod in cartParam.Products 


) 1{ 


total += prod?.Price ?? ð; 


return total; 
} 
} 


第 一 个 参数 前 面 的 this 关 键 字 表明 TotalPrices 是 
一 个 扩展 方法 ， 用 于 告诉 .NET 在 这 种 情况 下 可 以 对 
ShoppingCart 类 使 用 扩展 方法 。 我 们 可 以 使 用 
cartParam 参 数 引 用 扩展 方法 作用 的 ShoppingCart 实 
例 。 这 里 的 方法 枚 举 了 ShoppingCart 中 的 Product 并 
且 返 回 Product.Price 属 性 的 总 值 。 代 码 清单 4-21 显 示 
了 如 何在 Home 控 制 器 的 操作 方法 中 应 用 扩展 方 
cae 








扩展 方法 不 能 打破 闫 为 目 身 的 方法 、 字 段 和 属 


性 定义 的 访问 规则 。 可 以 利用 扩展 方法 扩展 类 的 功 
能 ， 但 是 只 能 使 用 允许 访问 的 类 成 员 。 


代码 清单 4-21 在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 使 用 扩展 方法 





using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 
ShoppingCart cart 


= new ShoppingCart { Products = Product.Get 
Products() }; 


decimal cartTotal = cart.TotalPrices(); 


return View("Index", new string[] { $"Total 
: {cartTotal:C2}" }); 


} 





关键 的 声明 语句 如 下 : 


decimal cartTotal = cart.TotalPrices(); 





TE ShoppingCart% % F iil HA TotalPrices 77 AY wi 
像 这 个 方法 是 ShoppingCart 类 的 成 员 一 样 ， 尽 管 它 
是 一 个 由 不 同类 定义 的 扩展 方法 。 如 有 果 扩 展 类 在 当 
前 类 的 作用 域内 ，.NET 将 可 以 但 找到 它们 ， 因 为 它 
们 在 同一 个 命名 空间 中 ， 或 者 在 using 语 句 指 定 的 命 
名 空间 中 。 如 采 运 行 示例 程序 ， 浏 览 器 窗口 会 显示 
以 下 输出 : 


Total: $323.95 


4.7.1 将 扩展 方法 应 用 于 接口 























我 们 也 可 以 创建 应 用 于 接口 的 扩展 方法 ， 这 人 多 
许 我 们 在 实现 接口 的 所 有 类 中 调用 它们 。 代 码 清单 
4-22 展 示 了 更 新 的 ShoppingCart 类 ， 它 实现 了 
IEnumerable<Product> 接 口 。 








代码 清单 4-22 ”在 Models 文 件 夹 下 的 ShoppingCart.cs 文 件 中 实 
现 一 个 接口 


using System.Collections; 
using System.Collections.Generic; 


namespace LanguageFeatures.Models { 


public class ShoppingCart : IEnumerable<Product> { 
public IEnumerable<Product> Products { get; set 


ae 


public IEnumerator<Product> GetEnumerator() { 
return Products.GetEnumerator() ; 


} 


IEnumerator IEnumerable.GetEnumerator() { 
return GetEnumerator(); 





现在 可 以 更 新 扩展 方法 ， 以 便 处 理 
IEnumerable<Product>， 如 代码 清单 4-23 所 示 。 


代码 清单 4-23 ”在 Models 文 件 夹 下 的 MyExtensionMethods.cs 文 
件 中 更 新 一 个 扩展 方法 


using System.Collections.Generic; 


namespace LanguageFeatures.Models { 
public static class MyExtensionMethods { 


public static decimal TotalPrices(this IEnumera 
ble<Product> products) { 
decimal total = Q; 
foreach (Product prod in products) { 
total += prod?.Price ?? @; 


} 


return total; 





第 一 个 参数 的 类 型 被 更 改 为 
IEnumerable<Product>， 也 就 是 说 ， 方 法 体 中 的 
一 次 for 循 环 都 直接 作用 在 Product 对 象 上 。 使 用 接口 
意味 着 可 以 计算 由 任何 IEnumerable<Product> 枚 举 
的 Product 对 象 的 总 值 ， 其 中 既 包 括 ShoppingCart 实 
例 ， 也 包含 Product 对 象 数组 ， 如 代码 清单 4-24 所 
INe 
代码 清单 4-24 在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 

中 对 数组 使 用 扩展 方法 








using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 
public ViewResult Index() { 


ShoppingCart cart 
= new ShoppingCart { Products = Product 
.GetProducts() }; 


Product[] productArray = { 
new Product {Name = "Kayak", Price = 27 
5M}, 
new Product {Name = "Lifejacket", Price 
= 48.95M} 
}; 


decimal cartTotal = cart.TotalPrices(); 
decimal arrayTotal = productArray.TotalPric 


return View("Index", new string[] { 
$"Cart Total: {cartTotal:C2}", 
$"Array Total: {arrayTotal:C2}" }); 





如 果 运 行 示例 程序 ， 你 将 看 到 如 下 结 末 ， 结 
表明 不 省 Product 对 象 是 如 何 收集 的 ， 我 们 部 能 从 扩 








展 方法 中 获得 相同 的 结 末 : 


Cart Total: $323.95 
Array Total: $323.95 
4.7.2 ”创建 过 小 扩展 方法 


扩展 方法 可 以 用 于 猎 选 对 象 的 集合 。 作 用 在 
IEnumerable<T> 上 并 且 返 回 IEnumerable<T> 的 扩展 
方法 可 以 使 用 yield 关 键 字 将 选择 条 件 应 用 于 源 数 据 
中 的 项 ， 以 生成 结果 集 。 代 码 清 蛙 4-25 演 示 了 这 样 
一 种 扩展 方法 ， 已 将 其 添加 到 MyExtensionMethods 
类 中 。 





代码 清单 4-25 ”在 Controller 文 件 夹 下 的 MyExtensionMethods.cs 
文件 中 添加 过 滤 扩 展 方法 








using System.Collections.Generic; 


namespace LanguageFeatures.Models { 
public static class MyExtensionMethods { 


public static decimal TotalPrices(this IEnumera 


ble<Product> products) { 
decimal total = 0; 
foreach (Product prod in products) { 
total += prod?.Price ?? @; 
} 
return total; 
} 
public static IEnumerable<Product> FilterByPric 
el 
this IEnumerable<Product> productEnum, 
decimal minimumPrice) { 


foreach (Product prod in productEnum) { 
if ((prod?.Price ?? ©) >= minimumPrice) 


yield return prod; 





FilterByPrice 扩 展 方 法 采用 一 个 附加 参数 来 帮 
助 筛选 那些 Price 属 性 与 参数 相 匹 配 或 高 于 参数 的 
Product 对 象 ， 代 码 清 单 4-26 展 示 了 具体 用 法 。 








代码 清单 4-26 在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 使 用 过 滤 扩 展 方 法 


using Microsoft.AspNetCore.Mvc; 





using System.Collections.Generic; 
using LanguageFeatures.Models; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 


Product[] productArray = { 


new Product {Name = "Kayak", Price = 27 
5M}, 

new Product {Name = "Lifejacket", Price 

= 48.95M}, 

new Product {Name = "Soccer ball", Pric 
e = 19.50M}, 

new Product {Name = "Corner flag", Pric 
e = 34.95M} 


局 


decimal arrayTotal = productArray.FilterByP 
rice(20).TotalPrices(); 


return View( "Index", new string[] { $"Array 
Total: {arrayTotal:C2}" }); 
} 


} 





当 我 们 对 Product 对 象 数 组 调用 FilterByPrice 方 
法 时 ，TotalPrices 方 法 只 返回 那些 价格 高 于 20 美 元 
的 值 ， 用 于 计算 总 值 。 如 有 果 运 行 示例 程序 ， 浏 览 右 


窗口 会 显示 如 下 输出 : 


4.8 ”使 用 Lambda 表 达 式 


Lambda KARS FRZ, Lambda Kiz 
式 本 身 极 具 简 化 的 特性 就 会 产生 一 种 迷惑 。 为 了 理 
解 要 解决 的 问题 ， 我 们 沿用 之 前 定义 的 
FilterByPrice 扩 展 方 法 。 此 扩展 方法 用 来 根据 价格 
第 选 Product 对 象 ， 也 就 是 说 ， 如 果 还 要 通过 姓名 进 
行 饶 选 ， 那 么 需要 再 定义 一 个 过 滤 扩 展 方 法 ， 如 代 
码 清单 4-27 所 示 。 











代码 清单 4-27 在 Models 文 件 夹 下 的 MyExtensionMethods.cs 文 
件 中 添加 一 个 过 滤 扩 展 方法 








using System.Collections.Generic; 


namespace LanguageFeatures.Models { 


public static class MyExtensionMethods { 


public static decimal TotalPrices(this IEnumera 
ble<Product> products) { 
decimal total = Q; 
foreach (Product prod in products) { 
total += prod?.Price ?? @; 
} 


return total; 


} 


public static IEnumerable<Product> FilterByPric 


e( 
this IEnumerable<Product> productEnum, 
decimal minimumPrice) { 


foreach (Product prod in productEnum) { 
if ((prod?.Price ?? ©) >= minimumPrice) 


yield return prod; 


} 


public static IEnumerable<Product> FilterByName( 


this IEnumerable<Product> productEnum, 
char firstLetter) { 


foreach (Product prod in productEnum) { 
if (prod?.Name?[@] == firstLetter) { 
yield return prod; 


} 





代码 清香 4-28 展 示 了 如 何在 控制 占 中 使 用 两 种 
过 涛 扩展 方法 来 创建 两 个 不 同 的 总 量 。 








代码 清单 4-28 在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 使 用 两 种 过 小 扩展 方法 








using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 


Product[] productArray = { 


new Product {Name = "Kayak", Price = 27 
5M}, 
new Product {Name = "Lifejacket", Price 
= 48.95M}, 
new Product {Name = "Soccer ball", Pric 
e = 19.50M}, 
new Product {Name = “Corner flag", Pric 
e = 34.95M} 


J3 


decimal priceFilterTotal = productArray.Fil 
terByPrice(20).TotalPrices(); 

decimal nameFilterTotal = productArray.Filt 
erByName('S').TotalPrices(); 


return View("Index", new string[] { 
$"Price Total: {priceFilterTotal:C2}", 
$"Name Total: {nameFilterTotal:C2}" }); 








第 一 个 过 滤 扩 展 方法 选择 价格 为 20 美 元 以 上 的 
所 有 了 商品， 第 二 个 过 滤 扩 展 方法 选择 名 称 以 字母 5 
开头 的 商品 。 如 果 运 行 示 例 程序 ， 你 将 在 浏览 器 窗 
口中 看 到 以 下 输出 : 


Price Total: $358.90 
Name Total: $19.50 


4.8.1 定义 函数 





可 以 不 断 重 复 以 上 过 程 ， 并 为 感 兴趣 的 每 一 个 
as 
的 方式 是 将 处 理 枚 举 的 代码 从 选择 条 件 中 分 
来 。 用 C# 人 处理 这 个 比较 简单 ，C# 通 过 人 允许 函 oes 
为 对 象 传递 实现 了 这 一 操作 。 代 码 清 单 4-29 展 示 了 








一 个 扩展 方法 ， 用 于 过 滤 Product 对 象 的 枚 举 ， 但 将 
选择 结果 中 元 素 的 决策 操作 委托 给 了 一 个 单独 的 函 
BN 








代码 清单 4-29 在 Models 文 件 夹 下 的 MyExtensionMethods.cs 文 
件 中 创建 第 规 的 Filter 方 法 





using System.Collections.Generic; 
using System; 


namespace LanguageFeatures.Models { 
public static class MyExtensionMethods { 


public static decimal TotalPrices(this IEnumera 
ble<Product> products) { 
decimal total = Q; 
foreach (Product prod in products) { 
total += prod?.Price ?? @; 


return total; 


} 


public static IEnumerable<Product> Filter( 
this IEnumerable<Product> productEnun, 
Func<Product, bool> selector) { 


foreach (Product prod in productEnum) { 
if (selector(prod)) { 
yield return prod; 





Filter 方 法 的 第 二 个 参数 是 一 个 接收 Product 对 
象 并 返回 bool 值 的 函数 。Eilter 方 法 为 每 个 Product 对 
象 调 用 该 函数 ， 如 果 人 返回 true， 束 将 Product 对 象 添 











加 到 结果 中 。 要 使 用 Filter 方 法 ， 可 以 指定 另 一 个 方 
法 或 创建 独立 的 函数 ， 如 代码 请 单 4-30 所 示 。 


代码 清单 4-30 在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 使 用 函数 来 过 滤 Product 对 象 





using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 
using System; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


bool FilterByPrice(Product p) { 
return (p?.Price ?? ©) >= 20; 
} 


public ViewResult Index() { 


Product[] productArray = { 


new Product {Name = "Kayak", Price = 27 
5M}, 

new Product {Name = "Lifejacket", Price 
= 48.95M}, 

new Product {Name = “Soccer ball", Pric 
e = 19.50M}, 

new Product {Name = “Corner flag", Pric 
e = 34.95M} 


J3 


Func<Product, bool> nameFilter = delegate ( 
Product prod) { 
return prod?.Name?[@] == 'S'; 


}; 


decimal priceFilterTotal = productArray 
.Filter(FilterByPrice) 
.TotalPrices(); 

decimal nameFilterTotal = productArray 
.Filter(nameFilter) 
.TotalPrices(); 


return View( "Index", new string[] { 
$"Price Total: {priceFilterTotal:C2}", 
$"Name Total: {nameFilterTotal:C2}" }); 





但 这 两 种 方式 都 不 理想 。FilterByPrice 这 样 的 
方法 会 扰乱 类 的 定义 。 创 建 Func<Product,bool> 对 象 


虽然 可 以 避免 这 个 问题 ， 但 其 举 拙 的 语法 难以 阅读 
和 维护 。Lambda 表 达 式 可 以 解决 这 个 问题 ， 从 而 以 
一 种 更 加 优雅 且 更 具 表 现 力 的 方式 来 定义 函数 ， 如 
代码 清单 4-31 所 示 。 





代码 清单 4-31 在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 使 用 Lambda 表 达 式 





using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 
using System; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 


Product[] productArray = { 


new Product {Name = "Kayak", Price = 27 
5M}, 

new Product {Name = "Lifejacket", Price 
= 48.95M}, 

new Product {Name = “Soccer ball", Pric 
e = 19.50M}, 

new Product {Name = “Corner flag", Pric 
e = 34.95M} 


}3 


decimal priceFilterTotal = productArray 
.Filter(p => (p?.Price ?? ©) >= 20) 


.TotalPrices(); 

decimal nameFilterTotal = productArray 
.Filter(p => p?.Name?[@] == 'S') 
.TotalPrices(); 


return View("Index", new string[] { 
$"Price Total: {priceFilterTotal:C2}", 
$"Name Total: {nameFilterTotal:C2}" }); 





在 代码 清单 4-31 中 ，Lambda 表 达 式 以 粗 体 显 
示 。 参 数 的 类 型 不 需要 指定 ， 可 自动 推 新 。 符 
号 “=>” 连 接 了 参数 和 Lambda 表 达 式 的 结果 。 在 示 
例 程序 中 ， 名 为 p 的 Product 人 参数 被 连接 到 bool 型 结 
果 。 如 果 Price 属 性 的 值 大 于 或 等 于 20 美 元 (第 一 个 
KISA) ， 或 者 Name 属 性 以 S 开 涉 〈 第 二 个 表达 
式 ) ， 那 么 参数 p 为 true。 虽 然 代 码 的 工作 方式 与 单 
独 的 方法 和 函数 代理 相同 ， 但 它 更 简洁 ， 对 于 大 多 
数 人 来 说 易 读 性 更 强 。 











Lambda 表 达 式 的 其 他 形式 


不 需要 在 Lambda 表 达 式 中 表达 委托 的 逻辑 。 
我 们 可 以 很 容易 地 调用 方法 ， 束 像 下 面 这 样 : 


prod => EvaluateProduct(prod) 


如 果 在 委托 函数 中 需要 具有 多 个 参数 的 
Lambda 表 达 age LEB AY AL TETAS, 
如 下 所 示 : 


(prod, count) => prod.Price > 20 && count > @ 


最 后 ， 如 果 需 要 在 具有 多 个 语句 的 Lambda 表 
达 式 中 使 用 逻辑 ， 那 么 可 以 换 用 大 括号 Hp) ， 并 
使 用 returmm 语 名 返回 结果 ， 如 下 所 示 : 





(prod, count) => { 
// <em>...multiple code statements...</em> 
return result; 


不 需 a 大 式 ， 但 它们 
确实 是 表达 复 森 函数 的 一 种 简单 清晰 的 方式 。 


4.8.2 ”使 用 Lambda 表 达 式 实现 方法 和 属性 


在 C# 6.0 中 ， 对 Lambda 进 行 了 扩展 以 便 它 们 可 
以 实现 方法 和 属性 。 在 MVC 开 发 中 ， 特 别 是 在 编写 
控制 右 时 ， 通 常会 使 用 包含 单个 语句 的 方法 来 选择 
要 显示 的 数据 和 要 呈现 的 视图 。 在 代码 清单 4-32 
中 ， 重 写 了 Index 操 作 方 法 。 





代码 清单 4-32 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 创建 公共 action 模 式 





using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 
using System; 

using System.Ling; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 
return View(Product.GetProducts().Select(p 
=> p?.Name)); 


} 





操作 方法 Index 将 从 静态 的 Product.GetProducts 
方法 中 获取 Product 对 象 的 集合 ， 并 使 用 LINQ 生 成 
Name 属 性 的 值 ， 然 后 用 作 默 认 视 图 的 视图 模型 。 
如 采 运 行 示例 程序 ， 你 将 在 浏览 器 窗口 中 看 到 以 下 
输出 : 


Kayak 
Lifejacket 


浏览 右 窗 口中 也 会 有 一 个 空 的 列表 项 ， 因 为 
GetProducts 方 法 在 结果 中 包含 了 null 引 用 ， 但 这 对 
本 章 的 这 一 部 分 并 不 重要 。 








当 一 个 方法 的 主体 由 单个 语句 组 成 时 ， 可 以 将 
其 重 写 为 Lambda 表 达 式 ， 如 代码 清单 4-33 所 示 。 





代码 清单 4-33 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 将 操作 方法 重 写 为 Lambda 表 达 式 


using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 
using System; 

using System.Ling; 


namespace LanguageFeatures.Controllers { 


public class HomeController : Controller { 


public ViewResult Index() => 
View(Product.GetProducts().Select(p => p?.Name) 





方法 的 Lambda 表 达 式 省 略 了 return 关 键 字 ， 并 
使 用 = > 将 方法 签名 (包括 参数 ) 与 其 实现 相关 
联 。 代 码 清单 4-33 所 示 的 Index 操 作 方 法 的 工作 方式 
与 代码 清单 4-32 中 的 相同 ， 但 表达 式 更 简洁 。 这 种 








基本 方法 也 可 以 用 来 定义 属性 。 代 码 清 单 4-34 显 示 
了 如 何在 Product 类 中 使 用 Lambda 表 达 式 来 谎 加 属 
性 。 


代码 清单 4-34 在 Models 文 件 夹 下 的 Product.cs 文 件 中 将 属性 表 
示 为 Lambda 表 达 式 





namespace LanguageFeatures.Models { 
public class Product { 


public Product(bool stock = true) { 
InStock = stock; 


} 


public string Name { get; set; } 

public string Category { get; set; } = "Watersp 
orts"; 

public decimal? Price { get; set; } 

public Product Related { get; set; } 

public bool InStock { get; } 

public bool NameBeginsWithS => Name?[@] == 'S'; 


public static Product[] GetProducts() { 


Product kayak = new Product { 
Name = "Kayak", 
Category = "Water Craft", 
Price = 275M 


}; 


Product lifejacket = new Product(false) { 
Name = "Lifejacket", 
Price = 48.95M 

}; 


kayak.Related = lifejacket; 


return new Product[] { kayak, lifejacket, n 





4.9 ”使 用 类 型 推断 和 匿名 类 型 


C# 的 var 关 键 字 人 允许 你 在 不 显 式 指定 变量 类 型 
的 情况 下 定义 局 部 变量 ， 如 代码 清单 4-35 所 示 ， 这 
PRIJA EW (type inference) 或 隐 式 类 型 。 


代码 清单 4-35 在 Controller 文 件 夹 下 的 HomeController.cs 文 件 
FA fie H SS A HEE DBT 





using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 
using System; 

using System.Ling; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 
public ViewResult Index() { 
var names = new [] { "Kayak", "Lifejacket", 
"Soccer ball" }; 
return View(names) ; 





names 变 量 并 不 是 没有 类 型 ， 相 反 ， 要 求 编译 
器 从 代码 中 推 新 出 类 型 。 编 译 器 检查 数组 声明 ， 并 
推 师 出 names 是 一 个 字符 串 数组 。 运 行 示 例 程 序 ， 
将 生成 以 下 输出 : 





Kayak 
Lifejacket 
Soccer ball 





使 用 匿名 类 型 


通过 组 合 对 象 的 初始 化 锋 和 次 型 推 产 ， 可 以 创 
建 简 单 的 视图 模型 对 象 ， 它 们 对 于 在 控制 融和 视图 
之 间 传 输 数据 很 有 用 ， 而 不 必定 义 类 或 结构 ， 如 代 


Ale 单 4-36 所 示 o 


代码 清单 4-36 在 Controller 文 件 夹 下 的 HomeController.cs 文 件 
中 创建 匿名 类 型 


using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 
uSing System; 

using System.Ling; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 
var products = new [] { 
new { Name = "Kayak", Price = 275M }, 
new { Name = "Lifejacket", Price = 48.9 
new { Name = "Soccer ball", Price = 19. 


new { Name = "Corner flag", Price = 34. 


}; 


return View(products.Select(p => p.Name)); 








products 数 组 中 的 每 个 对 象 都 是 匿名 类 型 的 对 


象 ， 但 这 并 不 是 说 在 这 种 情况 下 JavaScript 变 量 是 动 
ASH, TTA Ae RR an PERS A ER A EM 
强制 类 型 转换 仍 在 执行 。 例 如 ， 可 以 获取 并 设置 在 
初始 化 器 中 定义 的 属性 。 如 果 运 行 示例 程序 ， 你 将 
在 浏览 器 窗口 中 看 到 以 下 输出 : 

Kayak 

Lifejacket 


Soccer ball 
Corner flag 


C# 编 诺 闫 根据 初始 化 井中 参数 的 名 称 和 类 型 来 
生成 类 。 两 个 具有 相同 属性 名 和 类 型 的 匿名 类 型 对 
象 将 锌 分 配给 同一 个 目 动 生成 融 类 。 这 意味 看 
Product 数 组 中 的 所 有 对 象 部 将 其 有 相同 的 类 型 ， 因 
为 它们 拥有 相同 的 属性 。 











o 


提 ” 示 


必须 使 用 var 关 键 字 定义 匿名 类 型 对 象 的 数 
组 ， 由 于 在 代码 被 编译 之 前 不 会 指定 类 型 ， 因 此 不 
知道 要 使 用 哪 种 类型 。 匿 名 类 型 对 象 数 组 中 的 元 素 
必须 拥有 相同 的 属性 ， 人 否则 ， 编 译 融 无 法 确定 数组 


关 型 应 该 是 什么 。 








为 了 证 明 这 一 点 ， 更 改 代 码 清单 437 的 输出 ， 
以 便 显 示 类 型 名 称 而 不 是 Name 属 性 的 值 。 


代码 清单 4-37 在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 显示 Name 属 性 的 类 型 





using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 
using System; 

using System.Ling; 


namespace LanguageFeatures.Controllers { 


public class HomeController : Controller { 


public ViewResult Index() { 
var products = new [] { 
new { Name = "Kayak", Price = 275M }, 
new { Name = "Lifejacket", Price = 48.9 


SM }, 

new { Name = "Soccer ball", Price = 19. 
56M }, 

new { Name = "Corner flag", Price = 34. 
95M } 


bee 


return View(products.Select(p => p.GetType( 
).Name) ); 


} 


} 





products 数 组 中 的 所 有 对 象 都 被 分 配 相 同 的 类 
型 ， 类 型 名 称 并 不 友好 并 且 不 能 直接 使 用 ， 你 可 能 
会 看 到 与 以 下 输出 不 同 的 名 字 : 


<>f__AnonymousType@ 2 
<>f__AnonymousType@ 2 


<>f__AnonymousType@ 2 
<>f__AnonymousType@ 2 





4.10 (HR TIE 


C# 中 最 近 添 加 的 一 项 重要 内 容 是 对 异步 方法 
(asynchronous method) 的 处 理 方式 的 改进 。 异 步 
方法 会 在 后 台 进 行 ， 并 在 完成 后 通知 你 ， 这 样 在 执 
行 后 台 工 作 时 代码 束 能 够 处 理 其 他 事务 。 措 步 方法 
是 从 代码 中 消除 瓶 筑 ， 并 人 允许 应 用 程序 利用 多 个 处 

理 研 和 处 理 需 内 核 并 行 执行 工作 的 重要 工具 。 








在 MVC 中 ， 异 步 方 法 可 以 提高 应 用 程序 的 总 
体 性 能 ， 这 是 因为 服务 器 在 调度 和 执行 请 求 的 方式 
上 有 了 更 大 的 灵活 性 。C# 关 键 字 async 和 await 用 于 
异步 工作 的 执行 。 





为 此 ， 和 需要 在 示例 项 目 中 添加 一 个 新 的 .NET 程 
序 集 ， 以 便 可 以 进行 异步 HTTP 请求。 在 Solution 
Explorer 窗 格 中 右 击 LanguageFeatures 文 件 严 ， 在 弹 
出 的 菜单 中 选择 Edit LanguageFeatures.csproj， 添 加 
一 些 内 容 ， 如 代码 清早 4-38 所 示 。 


代码 清单 4-38 ”在 LanguageFeatures 文 件 夹 下 的 
LanguageFeatures.csproj 文 件 中 添加 程序 集 引 用 





<Project Sdk="Microsoft.NET.Sdk.Web"> 


<PropertyGroup> 
<TargetFramework>netcoreapp2.0</TargetFramework> 

</PropertyGroup> 

<ItemGroup> 


<Folder Include="wwwroot\" /> 
</ItemGroup> 


<ItemGroup> 


<PackageReference Include="Microsoft.AspNetCore.All 
" Version="2.0.0" /> 


<PackageReference Include="System.Net.Http"” Version 
="4.3.2" /> 


</ItemGroup> 


</Project> 





TE fk 4¥ LanguageFeatures.csproj 文件 后 ，Visual 
Studio 将 下 载 System.Net.Http 程 序 集 并 将 其 添加 到 项 
目 中 。 第 6 章 将 更 详细 地 描述 这 一 过 程 。 








4.10.1 直接 使 用 任务 


C# 和 .NET 对 异步 方法 有 很 好 的 支持 ， 但 代码 
往往 十 分 见长 ， 并 且 不 习惯 并 行 编程 的 开发 人 员 通 
第 会 因为 不 同 的 语法 而 感到 困惑 。 例 如 ， 代 码 清 单 
4-39 显 示 了 MyAsyncMethods 类 中 定义 的 
GetPageLength 腊 步 方 法 ， 可 将 其 添加 到 
MyAsyncMethods.cs 类 文件 。 





代码 清单 4-39 Models 文 件 夹 下 的 MyAsyncMethods.cs 文 件 的 
内 容 





using System.Net .Http ; 
using System.Threading.TasKs ; 


namespace LanguageFeatures.Models { 
public class MyAsyncMethods { 
public static Task<long?> GetPageLength() { 
HttpClient client = new HttpClient(); 


var httpTask = client.GetAsync("http://apre 
SS.com"); 


return httpTask.ContinueWith( (Task<HttpResp 
onseMessage> antecedent) => { 
return antecedent.Result.Content.Header 


s.ContentLength; 
})3 





上 述 代 码 使 用 一 个 System.Net.Http.HttpClient 对 
象 请 求 Apress 主 页 的 内 容 并 返回 内 容 的 长 度 。.NET 
代表 将 被 异步 完成 的 任务 。Task 对 象 根据 后 台 工 作 
产生 的 结果 强制 进行 类 型 化 。 所 以 ， 当 调用 
HttpClient.GetAsync 方 法 时 ， 得 到 的 是 一 个 
Task<HttpResponseMessage> 对 象 。 这 说 明 请 求 将 在 
后 侣 执行， 并且 返回 的 结 末 是 一 个 
HttpResponseMessage 对 象 。 





二 


fe ” 示 





当 使 用 “后 台 运 行 * 这 样 的 字眼 时 ， 表 示 跳 过 很 
多 细节 ， 只 聚焦 MVC 相 关 的 关键 点 。.NET 对 异步 
方法 和 并 行 编程 的 文 持 是 非常 好 的 ， 如 果 要 创建 能 
够 利用 多 核 和 多 处 理 器 硬件 的 真正 高 性 能 的 应 用 程 
序 ， 建 议 你 进一步 了 解 它 。 随 着 更 多 功能 被 介绍 ， 
你 将 看 到 MVC 如 何 使 创建 异步 Web 应 用 程序 变 得 容 


J o 








在 本 例 中 ， 使 用 ContinueWith 方 法 处 理 从 
HttpClient 返 回 的 对 象 。 在 GetAsync 方 法 中 ， 使 用 一 
个 Lambda 表 达 式 在 HttpResponseMessage 中 返回 一 
个 属性 的 值 ， 其 中 包含 从 Apress Web 服 务 器 获取 的 
PIAS EN IR RE 





return httpTask.ContinueWith( (Task<HttpResponseMessage> 
antecedent) => { 
return antecedent.Result.Content.Headers.ContentLen 
gth; 


F); 





请 注意 ， 以 上 代码 使 用 了 两 次 return 天 键 字 。 
第 一 次 使 用 return 天 键 字 是 为 了 指定 返回 一 个 Task 
<HttpResponseMessage> 对 象 ， 当 任务 完成 时 ， 将 返 
a 的 长 度 。 I 

回 一 个 可 为 null 的 long 值 ， 这 意味 着 
mann 的 返回 结果 是 Task <long?>, 如 
下 所 示 : 


public static Task<long?> GetPageLength() { 


NEES ITT Te BAL, HN BED, 
因为 很 多 人 也 会 遇 到 同样 的 问题 ， 为 此 微软 在 C# 中 
添加 了 两 个 关键 字 来 简化 卉 步 方法 的 使 用 。 








4.10.2 ”使 用 async 和 await 关 键 字 


C#5 引 入 了 两 个 关键 字 ， 专 门 用 于 简化 异步 方法 
(如 HttpClient.GetAsync) 的 使 用 。 这 两 个 关键 字 
是 async 和 await， 代 码 清单 4-40 展 示 了 怎样 应 用 它们 
来 简化 异步 方法 的 使 用 。 








代码 清单 4-40 在 Models 文 件 夹 下 的 MyAsyncMethods.cs 文 件 
中 使 用 async 和 await 关 键 字 


using System.Net .Http ; 
using System.Threading.TasKs ; 


namespace LanguageFeatures.Models { 


public class MyAsyncMethods { 


public async static Task<long?> GetPageLength() 


HttpClient client = new HttpClient(); 


var httpMessage = await client.GetAsync("ht 
tp://apress.com"); 


return httpMessage.Content.Headers.ContentL 
ength; 


} 





在 调用 异步 方法 时 使 用 了 await 关 键 字 ， 从 而 告 
诉 C# 编 译 器 要 等 待 GetAsync 方 法 返回 Task 结 果 ， 然 
后 继续 执行 同一 方法 中 的 其 他 语句 。 





应 用 await 关 键 字 意味 着 可 以 处 理 从 GetAsync 方 
法 返回 的 Task 结 果 ， 尽 和 党 GetAsync 只 是 各 规 方法 并 
且 只 返回 给 HttpResponseMessage 对 象 一 个 值 。 最 重 
要 的 是 ， 可 以 通过 正 第 的 方式 使 用 其 他 方法 的 
return 大 键 字 返回 结果 ， 在 本 例 中 也 就 古 
ContentLength 属 性 的 值 。 这 是 一 种 顺理成章 的 技 
术 ， 意 味 着 我 们 不 必 担 心 ContinueWith 方 法 和 return 
关键 字 的 多 次 使 用 。 














使 用 await 关 键 字 时 ， 还 必须 将 async 关 键 字 添 
加 到 方法 签名 中 ， 就 像 在 示例 中 所 做 的 那样 。 方 法 
的 返回 结果 类 型 不 变 。 示 例 中 的 GetPageLength 方 法 
仍然 返回 Task <long? >， 这 是 因为 await 和 async 关 
键 字 是 使 用 一 些 巧 妙 的 编译 技巧 实现 的 : 允许 使 用 








一 种 更 目 然 的 语法 ， 但 并 不 会 改变 应 用 它们 的 方法 
要 执行 的 操作 。 在 调用 GetPageLength 方 法 时 仍然 要 
处 理 Task <long? > 结果 ， 因 为 仍 有 后 人 台 操 作 会 生成 
可 为 nul 的 long 值 ， 当 然 ， 程 序 员 也 可 以 选择 使 用 
await 和 async 关 键 字 。 














以 上 模式 将 贯穿 于 整个 MVC 控 制 器 ， 这 使 得 
写 异 步 操 作 方 法 变 得 简单 ， 如 代码 清单 4-41 所 
示 。 


代码 清单 4-41 在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 定义 异步 操作 方法 





using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 
using System; 

using System.Ling; 

using System. Threading. Tasks; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public async Task<ViewResult> Index() { 
long? length = await MyAsyncMethods.GetPage 


Length(); 
return View(new string[] { $"Length: {lengt 
h}" }); 
} 


} 


} 





这 里 已 将 Index 操作 方法 的 结果 修改 为 
Task<ViewResult>， 从 而 告诉 MVC 该 操作 方法 将 返 
回 一 个 Task 对 象 并 在 完成 时 生成 一 个 ViewResult 对 
象 ， 提 供 泻 染 视图 所 需 的 详细 信息 和 数据 。 这 里 为 
方法 定义 添加 了 async 关 键 字 ， 这 样 束 可 以 在 调用 
MyAsyncMethods.GetPathLength 方 法 时 使 用 await 关 
键 字 了 。MVC 和 .NET 人 负责 处 理 后 续 事项 ， 从 而 得 
到 易于 编写 、 兄 于 阅读 、 易 于 维护 的 异步 代码 。 如 
果 运 行 该 应 用 程序 ， 你 将 看 到 类 似 于 下 面 的 输出 内 
容 《〈 可 能 长 度 是 不 同 的 ， 因 为 Apress 网 站 的 内 容 经 
第 更 改 ): 


Length: 54576 








4.11 获取 名 称 





在 Web 应 用 开 及 中 有 许多 任务 需要 引用 参数 、 
变量 、 方 法 或 类 的 名 称 ， 比 如 处 理 用 户 输入 时 引发 
的 异常 或 者 创建 验证 错误 。 传 统 的 方法 是 使 用 硬 编 
人 码 的 方式 获得 名 称 ， 如 代码 清单 442 所 示 。 




















代码 清单 4-42 在 Controller 文 件 夹 下 的 HomeController.cs 文 件 
中 对 名 称 进行 硬 编码 





using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 
uSing System; 

using System.Ling; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 
var products = new [] { 


new { Name = "Kayak", Price = 275M }, 
new { Name = "Lifejacket", Price = 48.9 


5M }, 


new { Name = "Soccer ball", Price = 19. 


50M }, 


new { Name = "Corner flag", Price = 34. 


95M } 
}; 


return View(products.Select(p => $"Name: {p 
.Name}, Price: {p.Price}")); 


} 








调用 LINQ Select TAK E~ EFF BP, 
其 中 的 每 一 个 字符 串 都 包含 对 Name 和 Price 属 性 的 
便 编 码 引 用 。 运 行 应 用 程序 会 在 浏览 器 窗口 中 生成 
以 下 输出 : 








: Kayak, Price: 275 
: Lifejacket, Price: 48.95 


: Soccer ball, Price: 19.50 
: Corner flag, Price: 34.95 





这 种 方法 存在 的 问题 是 容易 出 现 错误 ， 要 么 
为 名 称 键入 有 误 ， 要 么 因为 代码 个 重 构 ， 而 字符 串 
中 的 名 称 却 没有 正确 更 新 。 结 果 容 易 产生 误导 ， 特 
别 容 易 出 现 问 题 。C#3 引 入 了 nameof 表 达 式 ， 由 编译 
项 负责 生成 名 称 字 符 串 ， 如 代码 清单 4-43 所 示 。 








代码 清单 4-43 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 使 用 nameof 表 达 式 


using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using LanguageFeatures.Models; 
using System; 

using System.Ling; 


namespace LanguageFeatures.Controllers { 
public class HomeController : Controller { 
public ViewResult Index() { 


var products = new [] { 
new { Name = "Kayak", Price = 275M }, 


new { Name = "Lifejacket", Price = 48.9 


new { Name "Soccer ball", Price = 19. 


new { Name "Corner flag", Price = 34. 


}; 


return View(products.Select(p => 
$"{nameof(p.Name)}: {p.Name}, {nameof(p 
.Price)}: {p.Price}")); 
} 
} 





编 详 项 通过 形 如 p.Name 的 方式 处 理 引 用 ， 以 便 











仅 将 最 后 一 部 分 包含 在 字符 串 中 ， 从 而 生成 与 前 面 
示例 中 相同 的 输出 。Visual Studio 提 供 了 nameof 表 
达 式 的 智能 感知 文 持 ， 可 提示 你 选择 引用 ， 并 且 在 
重 构 代 码 时 正确 地 更 新 表达 式 。 由 于 编译 右 负 责 处 
理 nameof 表 达 式 ， 因 此 使 用 无 效 引用 会 导致 编译 错 
误 ， 从 而 可 以 收 到 错误 引用 或 过 期 引用 的 通知 。 








4.12 ”小结 





本 章 概 述 了 一 名 合格 的 MVC 程 序 员 需要 了 解 
的 关键 C# 特 征 。C# 是 一 种 非常 灵活 的 语言 ， 提 供 
各 种 不 同 的 方法 来 处 理 各 种 问题 ， 但 这 些 问 题 又 是 
Web 应 用 开发 过 程 中 经 常会 遇 到 的 ， 这 在 本 书 的 很 
多 示例 中 都 有 体现 。 下 一 章 将 介绍 Razor 视 图 引 
擎 ， 并 解释 如 何 将 之 应 用 于 MVC Web 应 用 程序 中 
以 生成 动态 内 容 。 

















5m ”使 用 Razor 


在 ASP.NET Core MVC 应 用 程序 中 ， 视 图 引擎 
(view engine) 负责 处 理发 送 给 客户 端的 内 容 。 
MVC 框 架 中 默认 的 视图 引擎 称 为 Razor， 用 来 为 
HTML 文 件 添加 注释 说 明 并 将 这 些 动态 内 容 插入 发 
送 给 浏览 器 的 输出 中 。 


本 章 将 介绍 一 个 用 于 快速 解读 Razor 语 法 的 工 
上 其， 这 样 当 你 看 到 它 的 时 候 ， 束 可 以 马上 将 其 识别 
出 来 。 本 章 不 会 非常 详细 地 介绍 Razor 的 内 容 ， 把 
本 章 看 作 Razor 语 法 的 速成 指南 即 可 。 随 独 本 书 其 
他 章节 介绍 MVC 的 其 他 功能 ， 我 们 再 慢 慢 深入 介 
绍 。 关 于 在 基体 语 境 中 如 何 理解 Razor， 参 见 表 5- 
le 


表 5-1 在 具体 语 境 中 理解 Razor 








Razor 是 负责 将 数据 合并 到 HTML 文 档 中 的 视 医 























动态 生成 内 容 的 能 力 对 编写 Web 应 用 程序 是 必 不 可 少 的 ，Razor 提 供 了 可 


它 有 什么 作用 ? z Ss 
以 使 C# 语 句 轻 松 地 与 ASP.NET Core MVC 的 其 他 部 分 协同 工作 的 能 




















将 Razor 表 达 式 添加 到 视图 文件 的 静态 HTML 中 ，Razor 表 达 式 可 协助 生 
客户 端 请 求 的 响应 














怎样 使 用 ? 











有 哪些 容易 出 现 |Razor 表 达 式 可 以 包含 几乎 所 有 的 C# 语 句 ， 并 且 很 难 决定 逻辑 应 该 属于 视 
的 问题 或 限制 ? | 图 还 是 控制 器 ， 从 而 削弱 MVC 关 注 点 分 离 的 核心 理念 



































他 的 做 法 “| 可 以 编写 自己 的 视图 引擎 。 也 有 一 些 第 三 方 的 视图 引擎 可 以 使 用 ， 但 它 
们 往往 在 特定 情况 下 可 行 ， 不 提供 长 期 支持 

















表 5-2 列 出 了 本 章 要 完成 的 操作 。 


表 5-2 本章 要 完成 的 操作 










































































使 用 @model 表 达 式 定义 模型 类 型 ， 代码 清单 5-5、 代 码 清 和 



































访问 视图 模型 























使 用 @Model 表 达 式 访问 模型 对 象 5-14、 代 码 清单 5-17 
























































使 用 类 型 名 称 而 不 限定 它 代码 清单 5-6 和 代码 清单 
ase “| 创建 视图 导入 文件 
们 的 命名 空间 5-7 






























































4 单 5-8 一 代码 清 间 





















































单 5-11 一 代码 清 





























视图 启动 文件 
































将 数据 从 控制 器 传递 到 视 单 5-15 和 代码 清 
和 = ead 使 用 视图 包 j 和 代码 ; 
图 模型 之 外 的 其 他 视图 





















































4 单 5-18 和 代码 清 





























有 选择 地 生成 内 容 使 用 Razor 条 件 表达 式 












































使 用 Razor 的 foreach 表 达 式 
素 生 成 内 容 





5.1 准备 示例 项 目 


为 了 演示 Razor 是 怎样 工作 的 ， 首 先 创建 一 个 
ASP.NET Core Web Application (.NET Core) 项 目 
FRZ ARazor, WAZ AIAN St TH IAIN ABEE. Be 
下 来 ， 在 Startup.cs 文 件 中 局 用 了 MVC 的 默认 配置 ， 
如 代码 清单 5-1 所 示 。 


代码 清单 5-1 ”在 Razor 文 件 夹 下 的 Startup.cs 文 件 中 局 用 MVC 的 
默认 配置 


using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace Razor { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
if (env.IsDevelopment()) { 
app.UseDeveloperExceptionPage() ; 


} 

//app.Run(async (context) => { 

// await context.Response.WriteAsync("He 
llo World!"); 

/1})3 

app.UseMvcWithDefaultRoute() ; 





5.1.1 定义 模型 


接 下 来 ， 创 建 模型 文件 夹 Models， 并 在 其 中 添 
加 名 为 Product.cs 的 类 文件 ， 用 于 定义 代码 清单 5-2 
中 的 简单 模型 类 。 


代码 清单 5-2 Models 文 件 夹 下 的 Product.cs 文 件 的 内 容 


namespace Razor.Models { 
public class Product { 


public int ProductID { get; set; } 


public string Name { get; set; } 

public string Description { get; set; } 
public decimal Price { get; set; } 
public string Category { set; get; } 





5.1.2 ”创建 控制 占 


Startup.cs 文 件 中 的 配置 如 下 : 默认 情况 下 ， 
MVC 将 请 求 发 送 到 名 为 Home 的 控制 器 。 创 建 
Controllers 文 件 夹 ， 并 在 其 中 添加 名 为 





HomeController.cs 的 类 文件 ， 用 于 定义 代码 清单 5-3 
中 的 简单 控制 器 。 





代码 清单 5-3 ”Controllers 文 件 夹 下 的 HomeController.cs 文 件 的 
内 容 


using Microsoft.AspNetCore.Mvc; 
using Razor.Models; 


namespace Razor.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() { 

Product myProduct = new Product { 
ProductID = 1, 
Name = "Kayak", 
Description = "A boat for one person", 
Category = "Watersports", 
Price = 275M 

}; 


return View(myProduct) ; 





以 上 控制 器 定义 了 一 个 名 为 Index 的 操作 方法 
来 创建 和 填充 Product 对 象 的 属性 。 将 Product 对 象 传 


递 给 View 方 法 ， 以 便 泻 染 视 图 时 将 其 用 作 模 型 。 在 
调用 View 方 法 时 ， 并 不 指定 视图 文件 的 名 称 ， 这 样 
操作 方法 便 会 使 用 默认 视图 。 





5.13 ”创建 视图 


为 了 给 Index 操作 方法 创建 默认 视图 ， 创 建 
Views/Home 文 件 夹 ， 在 其 中 添加 MVC 视 图 页 面 文 
件 Index.cshtml， 其 中 的 内 容 如 代码 清单 5-4 所 示 。 


代码 清单 5-4 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 的 内 容 





@model Razor.Models.Product 


@{ 
Layout = null; 
} 
<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Index</title> 
</head> 


<body> 


Content will go here 
</body> 
</html> 





后 面 将 介绍 Razor 视 图 的 其 他 部 分 ， 并 演示 其 
中 一 些 内 容 的 不 同 作 用 。 在 学 习 Razor 的 时 候 ， 请 
记 住 一 点 ， 视 图 的 存在 是 为 了 同 用 户 表 达 模 型 的 一 
个 或 多 个 方面 。 也 就 是 说 ， 可 利用 从 一 个 或 多 个 对 
象 中 检索 到 的 数据 来 生成 HTML 页 面 文件 。 如 果 你 
仍 记 得 我 们 始终 试图 建立 可 以 发 送 到 客户 问 的 
HTML 页 面 ， 那 么 束 会 觉得 Razor 所 做 的 一 切 部 是 有 
意义 的 。 如 果 运 行 示例 应 用 程序 ， 你 将 看 到 图 5-1 
所 示 的 输出 。 


图 5-1 示例 应 用 程序 的 输出 


5.2 ”使 用 模型 对 象 





让 我 们 从 Index.cshtml 视 图 文件 的 第 一 行 开始 。 


@model Razor.Models.Product 


Razor 表 达 式 以 @ 字 符 开 头 。 在 本 例 中 ， 
@model 表 达 式 声明 了 将 从 操作 方法 传递 到 视图 的 
模型 对 象 的 类 型 。 这 样 就 可 以 通过 @model 来 访问 
视图 模型 对 象 的 方法 、 字 段 和 属性 ， 代 码 清 单 5-5 
显示 了 对 Index 视 图 所 做 的 简单 补充 。 








代码 清单 5-5 ”在 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 中 引 
用 视图 模型 对 象 的 属性 





@model Razor.Models.Product 


@{ 

Layout = null; 
} 
<!DOCTYPE html> 
<html> 
<head> 


<meta name="viewport" content="width=device-width" 


/> 


<title>Index</title> 
</head> 
<body> 
@Model .Name 
</body> 
</html> 





y> EA 
EE oe. 


这 里 使 用 @model 声 明 视 图 模型 对 象 的 类 型 ， 
而 使 用 @Model 访 问 Name 属 性 。 


如 果 运 行 应 用 程序 ， 你 将 看 到 图 5-2 所 示 的 输 





图 5-2 ”在 视图 中 读 取 属性 的 输出 


使 用 @model 表 达 式 指定 类 型 的 视图 称 为 强制 
类 型 视图 (strongly typed view) 。 当 键入 @model 
和 人 句点 时 ，Visual Studio 便 会 弹出 @model 表 达 式 成 
员 可 以 使 用 的 名 称 建议 ， 如 图 5-3 所 示 。 








图 5-3 Visual Studio 基 于 @model 表 达 式 为 成 员 名称 提 供 建议 


Visual Studio 对 成 员 名 称 的 可 视 化 建议 有 助 于 
避免 在 Razor 中 出 现 错误 。 根 据 个 人 意愿 ， 可 以 急 
略 这 些 建议 ，Visual Studio 将 高 亮 显 示 成 员 名 称 有 
问题 ， 以 便 进 行 更 正 ， 束 像 使 用 常规 的 C# 类 文件 一 








样 。 图 5-4 列 举 了 一 个 示例 ， 开 发 人 员 在 其 中 试图 

引用 @Model.NotARealProperty。Visual Studio 已 意 
识 到 开发 人 员 在 模型 类 型 中 指定 的 Product 类 没有 这 
样 的 属性 ， 因 而 在 编辑 器 中 局 完 显 示 错 误 。 








图 5-4 Visual Studio 为 @Model 表 达 式 报告 错误 





使 用 视图 导入 


当 在 Index.cshtml 文 件 的 开头 定义 模型 对 象 时 ， 
必须 导入 包含 模型 类 的 命名 空间 ， 如 下 所 示 : 


@model Razor.Models.Product 


默认 情况 下 ， 在 强制 类 型 的 Razor 视 图 中 引用 
的 所 有 类 型 都 必须 使 用 命名 空间 进行 限定 。 当 模型 





对 象 有 唯一 的 引用 类 型 时 ， 这 不 是 什么 大 问题 ， 但 
是 当 需 要 编写 更 复杂 的 Razor 表 达 式 时 ， 束 会 使 视 
PAA By eee Ae Se 





可 以 通过 在 项 目 中 添加 视图 导入 文件 来 指定 要 
搜索 类 型 的 命名 空间 集合 。 视 图 导入 文件 放 在 
Views 文 件 夹 中 ， 并 命名 为 -ViewImports.cshtml。 


YO 
v> we 
TE. Je. 


Views 文 件 夹 中 名 称 以 下 男 线 (_)〉 开头 的 文件 
不 会 返回 给 用 户 ， 从 而 将 想 要 呈现 的 视图 文件 和 文 
持 它 们 的 文件 区 分 开 。 视 图 导入 文件 和 布局 模板 

(和 后 介绍 〉 是 以 下 男 线 为 前 绥 的 。 





要 创建 视图 导入 文件 ， 请 在 解决 方案 资源 管理 
ax (Solution Explorer) 4 aie, wiv 
出 菜单 中 选择 Add > New Item， 然 后 从 ASP.NET 类 
别 中 选择 MVC View Imports Page 模 板 ， 如 图 5-5 所 
ZN o 





sl ri 
中 ASP.NET Configuration File ASP.NET Core 








图 5-5 ”创建 视图 导入 文件 


Visual Studio 会 自动 将 文件 的 名 称 设置 为 
_ViewImports. cshtml， 单 击 Add 按 钮 以 创建 该 文 
件 。 代 码 清单 5-6 展 示 了 添加 完 表 达 式 之 后 的 视 


图 。 


代码 清单 5-6 Views 文件 夹 下 的 _ViewImports.cshtml 文 件 的 内 


my 


4 


@using Razor.Models 


Razor 视 图 中 用 来 搜索 类 的 命名 空间 由 @ using 
表达 式 指 定 ， 后 面 跟着 相应 的 命名 空间 。 在 代码 清 
单 5-6 中 ， 已 为 Razor.Models 命 名 空间 添加 了 一 项 ， 
其 中 包含 了 示例 应 用 程序 的 模型 类 。 








现在 ，Razor.Models 命 名 空间 就 包含 在 视图 导 
入 文件 中 了 ， 可 以 从 Index.cshtml 文 件 中 移 除 命名 衬 
间 ， 如 代码 清单 5-7 所 示 。 





代码 清单 5-7 在 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 中 不 
使 用 命名 空间 引用 模型 类 








@model Product 


@{ 


Layout = null; 
} 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 


<title>Index</title> 
</head> 
<body> 
@Model .Name 
</body> 
</html> 





o 


je ” 示 





还 可 以 将 @using 表 达 式 添加 到 单个 视图 文件 
中 ， 这 将 允许 在 单个 视图 中 使 用 没有 命名 空间 的 类 


型 。 


5.3 ”使 用 布局 





Index.cshtml 视 图 文件 中 还 有 男 外 一 个 重要 的 
Razor 表 达 式 : 


at 


Layout = null; 
} 





这 是 一 个 Razor 代 码 块 ， 人 允许 在 视图 中 包含 C# 
语句 。Razor 代 人 码 块 以 @“{” 开 始 ， 以 “}” 结 束 ， 里 面 
包含 的 语句 将 在 呈现 视图 时 执行 





以 上 Razor 代 码 块 将 Layout 属 性 的 值 设置 为 
null。Razor 视 图 被 编译 为 MVC 应 用 程序 中 的 C# 
类 ， 并 且 用 基 类 定义 了 Layout 属 性 。 第 21 章 将 介绍 
具体 的 工作 方式 。 将 Layout 属 性 设置 为 null 的 效果 
束 是 告诉 MVC 视 图 是 自 包 含 的 ， 并 将 泻 染 客户 病 所 
需 的 所 有 内 容 。 








目 包 含 的 视图 对 于 简单 的 示例 应 用 程序 表现 比 
较 好 ， 但 是 一 个 真正 的 项 目 可 以 有 几 十 个 视图 ， 有 
些 视 图 将 共 盏 内 容 。 在 视 几 中 复制 共 主 内 容 叉 很 难 
常理 ， 尤 其 是 当 需 要 进行 更 改 并 且 必 须 跟踪 所 有 需 
要 更 改 的 视图 时 。 











当 一 个 模板 包含 公共 的 内 容 并 且 可 以 应 用 于 一 
个 或 多 个 视图 时 ， 比 较 好 的 方法 就 是 使 用 Razor 布 
局 。 对 布局 进行 更 改 时 ， 更 改 将 日 动 影 啊 使 用 布局 
的 所 有 视图 。 














5.3.1 创建 布局 





布局 通常 由 多 个 控制 占 使 用 的 视图 共 圣 ， 并 和 存 
储 在 Views/Shared 文 件 夹 中 ， 这 是 在 会 找 文 件 时 
Razor 会 自动 人 查看 的 位 置 之 一 。 为 了 创建 布局 ， 先 
创建 Views/Shared 文 件 夹 ， 石 击 后 从 弹出 瑟 单 中 选 
择 Add > New Item。 从 ASP.NET 类 别 中 选择 MVC 











View Layout Page 模 板 ， 并 将 文件 名 设置 为 
_BasicLayout.cshtml， 如 图 5-6 所 示 。 单 击 Add 按 钮 
创建 这 个 文件 (与 视图 导入 文件 一 样 ， 布 局 文件 的 
名 称 也 以 下 男 线 开 头 ) 。 





代码 清单 5-8 显 示 了 由 Visual Studio 创 建 的 
_BasicLayout.cshtml 文 件 的 初始 内 容 。 


代码 清单 5-8 ”Views/Shared 文 件 夹 下 的 _BasicLayout.cshtml 文 
件 中 的 初始 内 容 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>@ViewBag.Title</title> 
</head> 


<body> 
<div> 
@RenderBody() 
</div> 
</body> 
</html> 
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图 5-6 ”创建 布局 





布局 是 一 种 特殊 的 视图 形式 ， 代 码 中 已 高 有 党 显 
示 @ 表 达 式 。@RenderBody 方 法 的 调用 会 将 操作 方 
法 定义 的 视图 内 容 插入 布局 标记 中 。 


<div> 


@RenderBody() 
</div> 





布局 中 的 男 一 个 Razor 表 达 式 会 查找 名 为 
ViewBag.Title 的 属性 ， 以 便 设 置 title 元 素 的 内 容 。 


<title>@ViewBag.Title</title> 


ViewBag 人 允许 在 应 用 程序 中 传递 数据 值 ， 本 例 
中 是 指 在 视图 和 布局 之 间 传 递 。 在 将 布局 应 用 于 视 
图 时 ， 你 将 看 到 这 是 如 何 工作 的 。 




















布局 中 的 HIML 元 素 将 应 用 于 任何 使 用 它们 的 
视图 ， 并 且 提 供 了 一 个 用 于 定义 公共 内 容 的 模板 。 
在 代码 清单 5-9 中 ， 在 布局 中 琴 加 了 一 些 简单 的 标 
记 ， 这 样 模板 效果 就 很 明显 了 。 





代码 清单 5-9 在 Views/Shared 文 件 夹 下 的 _BasicLayout.cshtml 
文件 中 添加 内 容 








<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>@ViewBag.Title</title> 
<style> 
#mainDiv { 
padding: 20px; 
border: solid medium black; 


font-size: 20pt 


} 
</style> 
</head> 
<body> 
<h1>Product Information</h1> 
<div id="mainDiv"> 
@RenderBody ( ) 
</div> 
</body> 
</html> 











这 里 添加 了 标 头 元 素 以 及 一 些 CSS 来 为 包含 
@RenderBody 表 达 式 的 div 元 素 的 内 容 设置 样式 ， 这 
样 就 可 以 清楚 地 知道 哪些 内 容 来 自 布 局 ， 哪 些 内 容 
KA ALA 








5.3.2 ”使 用 布局 








要 将 布局 应 用 于 视图 ， 我 们 需要 设置 Layout 属 
性 的 值 ， 并 移 除 现在 由 布局 提供 的 HIML， 如 代码 
清单 5-10 所 示 的 html、head 和 body 元 素 。 


代码 清单 5-10 ”在 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 中 


应 用 布局 


@model Product 


@{ 
Layout = “_BasicLayout"; 
ViewBag.Title = “Product Name"; 


} 





Product Name: @Model.Name 











Layout 必 性 将 指定 用 于 视图 的 布局 文件 ， 但 不 
使 用 .cshtml 文 件 扩展 名 。Razor 将 在 /Views/Home 和 
Views/Shared 文 件 夹 中 查找 指定 的 布局 文件 。 








上 面 还 设置 了 ViewBag.Title 属 性 。 在 演 染 视图 
的 时 候 ， 布 局 会 使 用 该 属性 设置 title 元 素 的 内 容 。 








即使 是 非常 简 捍 的 应 用 ， 视 图 的 这 种 转换 也 是 
非常 激动 人 心 的 。 布 局 包含 了 任何 HTML 啊 应 所 需 
的 所 有 结构 ， 这 使 得 视图 只 需要 关注 同 用 户 呈 现 数 
据 的 动态 内 容 就 可 以 了 。 当 MVC 处 理 Index.cshtml 
文件 时 ， 将 应 用 布局 来 创建 统一 的 HIML 啊 应 ， 如 


























图 5-7 所 示 。 





Product Information 


Product Name: Kayak 








图 5-7 为 视图 使 用 布局 后 的 效果 


5.3.3 ”应 用 视图 局 动 文 件 





为 一 个 圾 要 交代 的 地 方 ， 就 是 必须 为 将 要 使 用 
的 每 个 视图 指定 布局 文件 。 因 此 ， 如 果 需 要 重 命名 
布局 文件 ， 束 必须 找到 引用 布局 文件 的 每 个 视图 并 
进行 更 改 ， 这 非常 容易 出 错 。 最 重要 的 是 ， 这 与 
MVC 应 用 程序 的 易 维护 宗旨 背 志 而 驰 。 











这 个 问题 可 以 通过 使 用 视图 启动 文件 (view 
start file〉 来 解决 。 在 泻 染 视图 的 时 候 ，MYVC 将 查 
找 一 个 名 为 ViewStart.cshtml 的 文件 。 这 个 文件 的 


内 容 将 被 视 为 包含 在 视图 文件 本 喘 中 ， 我 们 可 以 使 
用 这 个 功能 目 动 设置 Layout 属 性 的 值 。 


要 创建 视图 启动 文件 ， 请 右 击 Views 文 件 来 ， 
从 弹出 菜单 中 选择 Add > New Item， 然 后 从 
ASP.NET 类 别 中 选择 MVC View Start Page 模 板 ， 如 


图 5-8 所 示 。 


Visual Studio 会 目 动 将 文件 的 名 称 设置 为 
_ViewStart.cshtml， 单 击 Add 按 钮 ，Visual Studio 为 
这 个 文件 创建 的 初始 内 容 如 代码 清单 5-11 所 示 。 











图 5-8 ”创建 视图 局 动 文件 


代码 清单 5-11 Views 文 件 夹 下 的 _ViewStart.cshtml 文 件 的 初始 
内 容 


Layout = " Layout"; 
} 


为 了 将 布局 应 用 于 应 用 程序 中 的 所 有 视图 ， 更 
改 分 配给 Layout 属 性 的 值 ， 如 代码 清单 5-12 所 示 。 


代码 清单 5-12 ”在 Views 文 件 夹 下 的 _ViewStart.cshtml 文 件 中 应 
用 默认 视图 


Layout = "_BasicLayout"; 


} 





因为 视图 启动 文件 包含 Layout 属 性 的 值 ， 所 以 
可 以 从 Index.cshtml 文 件 中 删除 相应 的 表达 式 ， 如 代 
码 清 单 5-13 所 示 。 


代码 清单 5-13 ”更 新 Views 人 Home 文 件 严 下 的 Index.cshtml 文 件 
以 体现 视图 启动 文件 的 使 用 


@model Product 


@{ 
ViewBag.Title = “Product Name"; 


Product Name: @Model.Name 








不 必 指 定 要 使 用 的 视图 局 动 文件 。MVC 将 目 
动 定 位 视图 局 动 文件 并 使 用 里 面 的 内 容 。 视 图 局 动 
文件 中 定义 的 值 优先 ， 这 样 束 可 以 方便 地 重 写 视图 
局 动 文 件 。 








还 可 以 使 用 多 个 视图 局 动 文件 为 应 用 程序 的 不 
同 部 分 设置 默认 值 。Razor 会 查找 离 正在 处 理 的 视 
图 最 近 的 视图 局 动 文 件 ， 这 意味 看 可 以 通过 在 
Views/Home 或 Views/Shared 文 件 夹 中 添加 视图 启动 
文件 来 履 兰 默认 设置 。 











= 


务必 了 解 从 视图 局 动 文件 中 省 略 Layout 属 性 与 
将 Layout 属 性 设置 为 null 之 间 的 区 别 。 如 果 视 图 是 
目 包含 的 ， 并 且 不 希望 使 用 布局 ， 可 将 Layout 属 性 
设置 为 nulll。 如 果 省 略 Layout 属 性 ，MVC 将 认为 需 


要 布局 ， 并 且 应 该 使 用 已 在 视图 局 动 文 件 中 找到 的 
值 。 





5.4 ”使 用 Razor 表 达 式 





至 此 ， 我 们 已 经 了 解 了 视图 和 布局 的 基本 知 
识 ， 接 下 来 介绍 Razor 文 持 的 各 种 不 同 闫 型 的 表达 
式 ， 以 及 如 何 使 用 它们 来 创建 视图 内 容 。 在 优秀 的 
MVC 应 用 程序 中 ， 操 作 方 法 和 视图 的 角色 之 间 存 在 
者 明确 的 差异 ， 如 表 5-3 所 未 。 


表 5-3 ”操作 方法 和 视图 的 角色 差异 


ll 可 以 做 什么 不 能 做 什么 
图 模型 对 象 传递 到 视图 将 格式 化 数据 传递 到 视 医 
































为 了 充分 发 挥 MVC 的 优势 ， 我 们 需要 尊重 并 
保证 应 用 程序 不 同 部 分 之 间 的 分 离 。 正 如 你 将 看 到 
的 ，Razor 可 以 为 我 们 做 很 多 工作 ， 包 括 使 用 C# 语 
人 句 ， 但 是 不 能 使 用 Razor 执 行业 务 逻 辑 或 以 任何 方 
式 操 作 域 模型 对 象 。 








作为 一 个 简单 的 示例 ， 代 人 码 清单 5-14 显 示 了 一 
种 在 Index.cshtml 文 件 中 添加 表达 式 的 方式 。 








代码 清单 5-14 ”在 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 中 
添加 一 个 表达 式 


@model Product 


@{ 


ViewBag.Title = “Product Name"; 


<p>Product Name: @Model.Name</p> 
<p>Product Price: @($"{Model.Price:C2}")</p> 








你 可 以 在 操作 方法 中 设置 Price 属 性 的 值 ， 并 将 
其 传递 给 视图 。 虽 然 这 样 可 以 臭 效 ， 但 是 采用 这 种 
方法 会 破坏 MVC 模 式 目 里 的 优点 ， 并 降低 对 未 来 变 
化 的 啊 应 能 力 。 虽 然 ASP.NET Core MVC 不 强制 正 
确 使 用 MVC 模 式 ， 但 你 应 该 了 解 不 这 么 做 可 能 带 来 
的 影 啊 。 


处 理 数据 与 格式 化 数据 


区 分 处 理 数据 和 格式 化 数据 是 非 第 重要 的 。 视 


图 会 格式 化 数据 而 不 是 将 对 象 的 属性 格式 化 为 字符 
串 ， 这 就 是 之 前 将 Product 对 象 传递 给 视图 的 原因 。 











处 理 数据 (包括 选择 要 显示 的 数据 对 象 ) ee Hae Hl 
的 职责 ， 控 制 锅 将 调用 模型 来 获 取 和 修改 所 需 的 数 
据 。 有 时 很 难 弄 清楚 处 理 和 格式 化 之 间 的 界限 是 什 

， 但 作为 一 条 经 验 法 则 ， 认 慎 起见， 建议 把 除了 
ye 
到 控制 如 中 。 








5.4.1 插入 数据 


使 用 Razor 表 达 式 可 以 轻松 将 数据 插入 标记 
中 。 最 和 常见 的 方法 是 使 用 @Model 表 达 式 ，Index 视 
图 已 包含 具体 示例 ， 如 下 上 所 示 : 


<p>Product Name: @Model.Name</p> 


还 可 以 使 用 ViewBag 功 能 插入 数据 ， 也 就 是 之 


前 在 布局 中 用 来 设置 title 元 素 内 容 的 那 项 功能 。 
ViewBag 可 用 于 将 数据 从 控制 器 传递 到 视图 以 补充 
模型 ， 如 代码 清单 5-15 所 示 。 


代码 清单 5-15 ”在 Controller 文 件 严 下 的 HomeController.cs 文 件 
中 使 用 ViewBag 功 能 


using Microsoft.AspNetCore.Mvc; 
using Razor.Models; 


namespace Razor.Controllers { 
public class HomeController : Controller { 
public ViewResult Index() { 
Product myProduct = new Product { 
ProductID = 1, 
Name = "Kayak", 
Description = "A boat for one person", 


Category = "Watersports", 
Price = 275M 


}; 
ViewBag.StockLevel = 2; 


return View(myProduct); 





ViewBag 属 性 会 返回 一 个 可 用 于 定义 任意 属性 


的 dynamic 对 象 。 在 代码 清单 5-15 中 ， 定 义 了 一 个 
StockLevel 属 性 ， 并 将 属性 值 指定 为 2。 由 于 
ViewBag 是 动态 的 ， 因 此 不 必 事 先 声 明 属 性 名 称 ， 
但 这 意味 着 Visual Studio 无 法 为 ViewBag 属 性 提供 自 
动 完成 的 建议 。 








何 时 使 用 ViewBag 以 及 何 时 扩展 模型 是 经 验 和 和 
个 人 偏好 问题 。 作 者 喜欢 只 使 用 ViewBag 来 提供 说 
明 如 何 呈 现 数据 的 视图 提示 ， 而 非 用 于 显示 给 用 户 
的 数据 。 如 有 果 确 实 要 将 视图 包 用 于 显示 给 用 户 的 数 
据 ， 可 以 使 用 @ViewBag 表 达 式 来 访问 它们 ， 如 代 
码 清单 5-16 所 示 。 




















代码 清单 5-16 ”在 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 中 
显示 视图 包 





@model Product 


@{ 
} 


ViewBag.Title = “Product Name"; 


<p>Product Name: @Model.Name</p> 
<p>Product Price: @($"{Model.Price:C2}")</p> 
<p>Stock Level: @ViewBag.StockLevel</p> 











图 5-9 显 示 了 运行 结 





uct Nam 
C |O localhost 


Product Information 








图 5-9 ”使 用 Razor 表 达 式 插入 数据 的 结果 


5.4.2 设置 属性 值 





到 目前 为 止 ， 己 为 所有 的 示例 设置 了 元 系 的 内 
容 ， 但 也 可 以 使 用 Razor 表 达 式 来 设置 元 条 的 属性 
值 。 代 码 清 单 5-17 显 示 了 如 何 使 用 @Model 和 
@ViewBag 表 达 式 来 设置 Index 视 图 中 元 素 的 属性 
值 。 


代码 清单 5-17 在 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 中 
使 用 Razor 表 达 式 来 设置 属性 值 
@model Product 


@{ 
} 


ViewBag.Title = “Product Name"; 


<div data-productid="@Model.ProductID" data-stocklevel= 
"@ViewBag.StockLevel"> 
<p>Product Name: @Model.Name</p> 
<p>Product Price: @($"{Model.Price:C2}")</p> 
<p>Stock Level: @ViewBag.StockLevel</p> 
</div> 





这 里 使 用 Razor 表 达 式 设置 了 div 元 素 的 data 属 
性 值 。 


fe 7R 





名 称 由 data- 作 为 前 级 的 属性 ， 多 年 来 一 直 是 一 
种 创建 自 定义 属性 的 非 正式 方法 ， 而 今天 作为 
HTML5 的 一 部 分 已 成 为 正式 标准 的 一 部 分 。 它 们 
经 常 被 用 到 ， 所 以 JavaScript 代 码 可 以 定位 特定 的 元 
素 ， 并 且 CSS 样 式 可 以 得 到 更 精准 的 应 用 。 








如 果 运 行 示 例 程序 并 查看 发 送 到 浏览 器 的 
HTML 源 代码 ， 你 将 看 到 Razor 已 经 设置 了 属性 的 
值 : 


<div data-productid="1" data-stocklevel="2"> 
<p>Product Name: Kayak</p> 


<p>Product Price: £275.0@</p> 


<p>Stock Level: 2</p> 
</div> 





5.4.3 ”使 用 条 件 语句 


以 根据 视图 数据 中 的 值 调 整 视图 的 输出 。 这 种 技术 
是 Razor 的 核心 ， 使 得 使 用 者 可 以 创建 复杂 但 流畅 
的 布局 ， 同 时 又 易 读 、 易 于 维护 。 在 代码 清单 5-18 
中 ， 修 改 Index 视 图 以 包含 条 件 语句 。 





代码 清单 5-18 ”在 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 中 
使 用 Razor 条 件 语句 





@model Product 


@{ 
} 


<div data-productid="@Model.ProductID" data-stocklevel= 
"@ViewBag.StockLevel"> 
<p>Product Name: @Model.Name</p> 
<p>Product Price: @($"{Model.Price:C2}")</p> 
<p>Stock Level: 
@switch (ViewBag.StockLevel) { 
case @: 
@:Out of Stock 
break; 
case 1: 
case 2: 
case 3: 
<b>Low Stock (@ViewBag.StockLevel)</b> 
break; 
default: 


ViewBag.Title = "Product Name"; 


@: @ViewBag.StockLevel in Stock 
break; 





为 了 使 用 条 件 语句 ， 请 在 C# 条 件 关 键 字 的 前 面 
放置 @ 字 符 ， 如 示例 中 的 @switch。 束 像 使 用 常规 
的 C# 代 码 块 一 样 ， 代 码 块 的 终止 符号 为 右 大 括 
FP 

在 Razor 代 码 块 内 ， 可 以 通过 定义 HIML 和 
Razor 表 达 式 将 HTML 元 素 和 数据 包含 在 视图 输出 
中 ， 如 下 所 示 : 


<b>Low Stock (@ViewBag.StockLevel)</b> 


TOR MARIA LUA RRES 5S a DRE 
方式 表示 它们 Razor 引 警 会 将 它们 解释 为 要 处 
理 的 输出 。 但 是 ， 如 果 要 在 视图 中 不 包含 HTML 元 











素 时 问 其 中 插入 文本 ， 丈 需要 对 Razor 进 行 特殊 标 
注 ， 并 将 所 在 行 的 前 级 写成 如 下 形式 : 


@: Out of Stock 


@: 字 符 是 为 了 防止 Razor 被 解释 为 C# 语 句 ， 这 
是 遇 到 文本 时 的 默认 行为 。 你 可 以 在 网 5-10 中 看 到 
条 件 语句 的 结果 。 





Product Information 


Product Name: Kayak 


Product Price: £275.00 


Stock Level: Low Stock (2) 











图 5-10 ”在 Razor 视 图 中 使 用 开关 表达 式 





条 件 语句 在 Razor 视 图 中 很 重要 ， 因 为 它们 人 允 
许 根据 视图 从 操作 方法 接收 的 数据 来 对 内 容 进 行 更 
改 。 在 这 里 我 们 添加 一 些 额 外 的 演示 ， 人 代码 清单 5- 








19 ye AN S u Æ Index.cshtml X44 Fs Hifi). 


ARID 5-19 ”在 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 的 
Razor 视 图 中 使 用 if 语 句 





@model Product 
@{ 
} 


ViewBag.Title = "Product Name"; 


<div data-productid="@Model.ProductID" data-stocklevel= 
"@ViewBag.StockLevel"> 
<p>Product Name: @Model.Name</p> 
<p>Product Price: @($"{Model.Price:C2}")</p> 
<p>Stock Level: 


@if (ViewBag.StockLevel == @) { 
@:Out of Stock 
} else if (ViewBag.StockLevel > @ && ViewBag.St 
ockLevel <= 3) { 
<b>Low Stock (@ViewBag.StockLevel)</b> 
} else { 
@: @ViewBag.StockLevel in Stock 


} 
</p> 
</div> 





这 个 条 件 语句 的 结果 与 switch 语 句 相 同 ， 这 里 
演示 的 是 如 何 让 Razor 钢 图 与 C# 条 件 语句 相思 配 。 


第 21 章 将 会 解释 这 里 的 条 件 语句 是 怎样 工作 的 。 
5.4.4” 枚 举 数 组 和 集合 


在 编写 MVC 应 用 程序 时 ， 通 常 需 要 榴 举 数组 
的 内 容 或 条 些 其 他 类 型 对 象 的 集合 ， 并 针对 每 个 元 
素 内 容 执行 相应 的 操作 。 为 了 演示 这 是 如 何 完成 
的 ， 在 代码 清单 5-20 中 ， 修 改 Home 控 制 磺 中 的 
Index 操 作 方 法 ， 以 便 将 一 个 Product 对 象 数 组 传递 
给 视图 。 





代码 清单 5-20 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 使 用 数组 








using Microsoft.AspNetCore.Mvc; 
uSing Razor.Models; 


namespace Razor.Controllers { 
public class HomeController : Controller { 


public IActionResult Index() { 
Product[] array = { 
new Product {Name = "Kayak", Price = 27 


5M}, 
new Product {Name = "Lifejacket", Price 


= 48.95M}, 
new Product {Name = "Soccer ball", Pric 
e = 19.50M}, 
new Product {Name = "Corner flag", Pric 
e = 34.95M} 


5 
return View(array) ; 





Index 操 作 方 法 创建 了 一 个 包含 简单 数据 的 
Product[] 对 象 ， 并 将 它们 传递 给 View 方 法 ， 以 便 使 
用 默认 视图 呈现 数据 。 在 代码 清单 5-21 中 ， 更 改 
Index 视 图 的 模型 类 型 ， 并 使 用 foreach 循 环 枚 举 数 组 
中 的 每 个 对 象 。 


提 示 


代码 清单 5-21 中 的 Model 不 需要 以 @ 字 符 作 为 


前 级 ， 因 为 它 是 C# 表 达 式 的 一 部 分 。 我 们 很 难 弄 清 
楚 何 时 需要 使 用 @ 字 符 ， APEE N NN 
Visual Studio 49 fe% FD REP A He aN 


wet 


Ro 





代码 清单 5-21 在 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 中 
枚 举 数 组 





@model Product[] 


@t 
ViewBag.Title = "Product Name"; 
} 
<table> 
<thead> 
<tr><thoName</th><th>Price</th></tr> 
</thead> 
<tbody> 
@foreach (Product p in Model) { 
<tr> 
<td>@p .Name</td> 
<td>@($"{p.Price:C2}")</td> 
</tr> 


} 
</tbody> 


</table> 


@foreach 语 句 用 于 枚 举 Model 数 组 的 内 容 ， 并 
为 每 个 数组 元 素 生 成 一 行 数据 。 以 上 代码 在 foreach 
循环 中 创建 了 名 为 p 的 局 部 变量 ， 然 后 使 用 Razor 表 
达 式 @p.Name 与 @p.Price 引 用 属性 名 称 和 价格 ， 结 
果 如 图 5-11 所 示 。 








图 5-11 使 用 Rzaor 枚 举 数组 的 结果 


5.5 小结 


本 间 概 述 了 Razor 视 图 引 敬 以 及 如 何 用 它 生 成 
HTML， 介 绍 了 如 何 通 过 视图 模型 对 象 科 ViewBag 
来 引用 从 控制 器 传 来 的 数据 ， 以 及 如 何 使 用 Razor 





表达 式 根 据 数 据 定制 对 用 户 的 啊 应 。 接 下 来 的 章 市 
将 介绍 更 多 关于 Razor 用 法 的 示例 ， 第 21 章 将 详细 
介绍 MVC 视 图 的 机 制 。 下 一 章 将 介绍 Visual Studio 
为 使 用 ASP.NET Core MVC 项 目 而 提供 的 一 些 功 


全 已 
HE o 


第 6 音 ”使 用 Visual Studio 


本 章 主要 介绍 Visual Studio 为 开发 ASP.NET 
Core MVC 项 目 提 供 的 关键 特性 。 表 6-1 列 出 了 本 章 
要 完成 的 操作 。 





表 6-1 本 章 要 完成 的 操作 









































使 用 NuGet 工 具 管 理 .NET 包 ， 使 | 代码 清 六 


用 Bower 管 至 

















添加 包 到 项 目 中 




































































图 或 类 更 改 的 效果 于 发 模式 


















































在 浏览 器 中 显示 六 使 用 开发 人 员 调试 页 











获取 有 关 程序 执行 的 详细 信息 和 控 和 






































使 用 调试 器 










































































使 用 Visual Studio 重 新 加 载 一 个 或 代码 清单 6-14 和 
ie isual Studio 重 新 加 载 一 个 或 多 使 用 浏览 器 链接 
个 浏览 器 








减少 HITP 请 求 的 数量 以 及 JavaScript 


和 CSS 文 件 所 需 的 带宽 大 小 


6.1 



































使 用 Bundler & Minifier 扩 展 



































准备 示例 项 目 


在 本 章 中 ， 将 使 用 Empty 模板 创建 一 个 新 的 名 
AJWorkingWithVisualStudiolJASP.NET Core Web 
Application (.NET Core) 项 目 。 在 Startup.cs 文 件 中 
用 默认 配置 启用 MVC， 如 代码 清单 6-1 所 示 。 


代码 清单 6-1 ”在 WorkingWithVisualStudio 文 件 夹 下 的 Startup.cs 


文件 中 启用 MVC 





using 
using 
using 
using 
using 
using 
using 
using 


System; 

System.Collections.Generic; 

System. Ling; 

System. Threading.Tasks; 
Microsoft.AspNetCore. Builder; 
Microsoft.AspNetCore.Hosting; 
Microsoft.AspNetCore.Http; 

Microsoft. Extensions .DependencyInjection; 


namespace WorkingWithVisualStudio { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 


n services) { 
services.AddMvc(); 


I 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseMvcWithDefaultRoute(); 





6.1.1 创建 模型 


创建 Models 文 件 夹 ， 并 添加 名 为 Product.cs 的 类 
文件 ， 用 来 定义 代码 清单 6-2 中 的 类 ，。 
代码 清单 6-2 ”Models 文 件 夹 下 的 Product.cs 文 件 的 内 容 


namespace WorkingWithVisualStudio.Models { 


public class Product { 


public string Name { get; set; } 
public decimal Price { get; set; } 





为 了 创建 一 个 简单 的 Product 存 储 对 象 ， 在 
Models 文 件 夹 中 添加 名 为 SimpleRepository.cs 的 类 


文件 ， 用 来 定义 代码 清单 6-3 中 的 类 。 


代码 清单 6-3 ”Models 文 件 夹 下 的 SimpleRepository.cs 文 件 的 内 


IP 


谷 





using System.Collections.Generic; 


namespace WorkingWithVisualStudio.Models { 
public class SimpleRepository { 
private static SimpleRepository sharedRepositor 
y = new SimpleRepository(); 
private Dictionary<string, Product> products 
= new Dictionary<string, Product>(); 


public static SimpleRepository SharedRepository 
=> sharedRepository; 


public SimpleRepository() { 
var initialItems = new[] { 


new Product { Name = "Kayak", Price = 2 
75M }, 
new Product { Name = "Lifejacket", Pric 
e = 48.95M }, 
new Product { Name = "Soccer ball", Pri 
ce = 19.50M }, 
new Product { Name = "Corner flag", Pri 
ce = 34.95M } 
}; 
foreach (var p in initialItems) { 
AddProduct(p); 
} 


public IEnumerable<Product> Products => product 
s.Values; 


public void AddProduct(Product p) => products.A 
dd(p.Name, p); 
} 


} 





X 


这 个 类 会 将 模型 对 象 人 存储 在 内 存 中 ， 这 意味 着 
当 应 用 程序 停止 或 重新 局 动 时 ， 对 模型 所 做 的 任何 
更 改 都 将 丢失 。 非 持久 化 存储 对 于 本 章 中 的 示例 来 
说 已 经 足够 ， 但 对 于 许多 实际 项 目 来 说 并 不 可 取 。 
关于 创建 持久 化 存储 模型 对 象 的 示例 ， 请 参见 8 


代码 清单 6-3 定 义 了 一 个 名 为 SharedRepository 


的 静态 属性 ， 使 用 它 就 可 以 在 整个 应 用 程序 中 对 

SimpleRepository 对 象 进 行 访问 。 这 虽然 不 是 最 好 的 
做 法 ， 但 可 以 通过 它 展示 一 下 在 MVC 开 发 过 程 中 经 
第 会 迪 到 的 一 个 问题 。 第 18 章 将 介绍 如 何 使 用 共 至 


组 件 来 更 好 地 解决 这 个 问题 。 





6.1.2 创建 控制 器 和 视图 


在 项 目 中 创建 Controllers 文 件 夹 ， 并 添加 名 为 
HomeController.cs 的 类 文件 ， 用 来 定义 代码 清单 6-4 
中 的 控制 器 。 


代码 清单 6-4 ”Controllers 文 件 夹 下 的 HomeController.cs 文 件 的 
内 容 





using Microsoft.AspNetCore.Mvc; 
using WorkingWithVisualStudio.Models; 


namespace WorkingWithVisualStudio.Controllers { 
public class HomeController : Controller { 


public IActionResult Index() 
=> View(SimpleRepository.SharedRepository.P 
roducts); 


} 


} 








Index 操 作 方 法 会 获取 所 有 模型 对 象 并 将 它们 
传递 给 View 方 法 以 呈现 默认 视图 。 为 了 添加 默认 视 
图 ， 创 建 Views/Home 文 件 夹 ， 在 其 中 添加 名 为 
Index.cshtml 的 视图 文件 ， 里 面 的 内 容 如 代码 清单 6- 
5 所 示 。 


代码 清单 6-5 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 的 内 容 





@model IEnumerable<WorkingWithVisualStudio.Models.Produ 
ct> 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Working with Visual Studio</title> 
</head> 
<body> 
<table> 


<thead> 
<tr><td>Name</td><td>Price</td></tr> 
</thead> 
<tbody> 
@foreach (var p in Model) { 
<tr> 
<td>@p.Name</td> 
<td>@p.Price</td> 
</tr> 


} 
</tbody> 
</table> 
</body> 
</html> 








Index 视 图 中 包含 一 个 表格 ， 使 用 Razor foreach 
循环 为 每 个 模型 对 象 创 建行 ， 其 中 每 一 行 都 包含 
Name 和 Price 属 性 。 如 果 运 行 示例 应 用 程序 ， 你 将 
看 到 图 6-1 所 示 的 结果 。 


D Working with Visual Stuc x 





图 6-1 运行 示例 应 用 程序 的 结果 


6.2 管理 软件 包 





ASP.NET Core MVC 项 目 需 要 两 种 不 同类 型 的 
软件 包 ， 后 面 将 摘 述 其 中 的 每 种 类 型 以 及 Visual 
Studio 为 管理 它们 而 提供 的 工具 。 


6.2.1 NuGet 





为 了 管理 包含 在 项 目 中 的 .NET 包 ，Visual 
Studio 提 供 了 一 个 图 形 工具 NuGet。 要 打开 该 图 
形 工 具 ， 请 选择 Tools “NuGet Package 








Manager ~ Manage NuGet Packages for Solution, 5% 
出 的 界面 如 图 6-2 所 示 。 





Manage Packages for Solution 


a) 


园 Microsoft aspnetCore all 7 























图 6-2 ”弹出 的 界面 


Installed 选 项 卡 提 供 了 项 目 中 已 安装 的 包 的 摘 
要 信息 ，Browse 选 项 卡 可 用 于 定位 和 安装 新 的 包 ， 


Updates 选 项 卡 可 用 于 列 出 已 发 布 的 最 新 版 本 的 软件 
包 。 


Microsoft.AspNetCore.All 包 


如 果 使 用 了 早期 版 本 的 ASP.NET Core， 你 将 明 
白 向 新 项 目 添加 大 量 NuGet 包 的 必要 性 。ASP.NET 


Core 2 采用 不 同 的 方法 ， 依 赖 一 个 名 为 
Microsoft.AspNetCore.All 的 包 


Microsoft.AspNetCore.All 包 是 元 包 (meta- 
package) ， TEREE ne 
所 需 的 所 有 单个 NuGet 包 ， 这 意味 独 不 需要 逐个 添 
加 包 。 在 发 布 应 用 程序 时 ， 将 删除 元 meee 
Be FP (5 FS, DAR RS ae A H EK 
包 。 





NuGet 包 列表 和 位 置 


NuGet 工 具 在 <projectname>.csproj 文 件 中 提供 
了 包 的 有 关 信 息 ， 其 中 <projectname> 可 由 项 目 名 称 
蔡 换 。 对 于 示例 应 用 程序 ， 这 意味 着 NuGet 包 的 详 
细 信 息 存 储 在 名 为 WorkingWithVisualStudio.csproj 


的 文件 中 。Visual Studio 不 会 在 Solution Explorer fi 
格 中 显示 .csproj 文 件 。 要 编辑 该 文件 ， 请 在 Solution 
Explorer 窗 格 中 右 击 项 目 ， 然 后 在 弹出 的 人 于 单 中 选 
择 Edit WorkingWithVisualStudio.csproj. Visual 
Studio 将 打开 该 文件 进行 编辑 。.csproj 文 件 是 XML 
格式 的 ， 你 将 看 到 类 似 下 面 这 样 的 元 素 ， 从 而 将 
ASP.NET Core 元 包 添 加 到 项 目 中 : 








<ItemGroup> 


<PackageReference Include="Microsoft.AspNetCore.Al1" 
Version="2.0.0" /> 
</ItemGroup> 








为 每 个 包 指 定名 称 和 所 需 的 版 本 号 。 尺 管 元 
包括 ASP.NET Core MVC 所 需 的 所 有 功能 ， 但 你 仍 
必须 将 包 添 加 到 项 目 中 ， 以 便 可 以 使 用 附加 功能 
可 以 使 用 图 6-2 所 示 的 界面 或 使 用 命令 行 工具 来 添 
加 软件 包 。 也 可 以 直接 编辑 .csproj 文 件 ，Visual 








Studio 会 检测 到 更 改 并 下 载 和 安装 相应 的 软件 包 。 


当 使 用 NuGet 将 一 本 包 添 加 到 项 目 中 时 ， 这 个 
包 将 与 它 所 依赖 的 所 有 包 一 起 和 目 动 安 装 。 可 以 通过 
在 Solution Explorer 窗 格 中 选择 
Dependencies ~“ NuGet 来 研究 NuGet 包 及 其 依赖 项 。 
ASP.NET Core 元 包 具 有 大 量 的 依赖 项 ， 其 中 一 些 依 
赖 项 如 图 6-3 所 示 。 
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6-3 Solution Explorer 窗 格 中 的 一 些 依赖 项 


6.2.2 Bower 


ZP mE (client-side package) 是 包含 发 送 到 
Fe Pm A AEA, «JavaScript sce. Re PETZ 
或 网 像 。NuGet 过 去 也 用 来 管理 这 些 项 目 ， 但 是 
ASP.NET Core MVC 依 赖 于 Bower 工 具 。Bower 是 一 
个 开源 工具 ， 己 经 独立 于 Microsoft 和 .NET 开 发 完 
成 ， 并 被 广泛 应 用 于 非 ASP.NET Web 应 用 程序 的 开 
发 中 。 





Bower 最 近 已 弃 用 。 但 是 ，Bower 仍 在 积极 维 
护 中 ， 并 且 对 Bower 的 文 持 已 集成 到 Visual Studio 
HH 


在 某 些 时 候 ， 可 以 期 望 Microsoft 文 持 其 他 用 于 


管理 客户 问 包 的 工具 ， 但 是 在 这 种 情况 发 生 之 前 ， 
应 该 继续 使 用 Bower。 


1. Bower 包 列表 


Bower 包 可 通过 bower.json 文 件 指定 。 要 创建 
Bower 配 置 文件 ， 请 在 Solution Explorer 窗 格 中 右 击 
Working WithVisualStudio 项 目 ， 从 弹出 的 采 单 中 选 
择 Add — New Item， 然 后 在 左 侧 窗 格 中 选择 
ASP.NET Core > Web ~ General， 在 右 侧 窗 格 中 选择 
Bower Configuration File 项 目 模板 ， 如 图 6-4 所 示 。 





Add New Item - WorkingWithVisualStudio 
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图 6-4 创建 Bower 配 置 文件 


Visual Studio 已 将 名 称 设置 为 bower.json， 单 击 
Add 按 钮 将 该 文件 添加 到 项 目 中 ， 默 认 内 容 如 代码 
清单 6-6 所 示 。 


代码 清单 6-6 bower.json 文 件 的 默认 内 容 


"name": "asp.net", 
"private": true, 


"dependencies": { 


} 


} 








代码 清单 6-7 显 示 了 将 客户 端 包 和 深 加 到 


bower.json 文 件 中 的 方法 ， 这 是 通过 添加 与 
project.json 文 件 相同 格式 的 项 到 dependencies 部 分 来 
实现 的 。 


二 


提 示 





Bower 软 件 包 的 存储 库 参 见 Bower 网 站 ， 可 以 
在 其 中 搜索 要 添加 到 项 目 中 的 软件 包 。 


代码 清单 6-7 ”在 bower.json 文 件 中 添加 包 





{ 
"name": "asp.net", 
"private": true, 
"dependencies": { 
"bootstrap": "3.3.7" 


} 


以 上 代码 将 Bootstrap CSS 包 添加 到 了 示例 项 目 
中 。 当 编辑 bower.json 文 件 时 ，Visual Studio 将 为 你 
提供 一 个 包 名 列表 ， 并 列 出 可 用 包 的 版 本 ， 如 图 6- 
5 所 示 。 








图 6-5” 列 出 客户 端 包 的 可 用 版 本 


在 编写 本 书 时 ，Bootstrap 包 的 最 新 版 本 是 
3.3.7。 但 是 请 注意 ，Visual Studio 提 供 了 3 个 版 本 
号 ， 分 别 是 3.3.7、A^3.3.7 和 ”3.3.7。 在 bower.json 文 
件 中 ， 版 本 号 可 以 不 同 的 方式 指定 ， 一 些 第 用 模式 
如 表 6-2 所 示 。 指 定 包 的 最 安全 方法 是 使 用 显 式 的 





版 本 号 。 这 样 就 能 确保 始终 使 用 相同 的 版 本 ， 除 非 
特意 更 新 bower.json 文 件 来 更 换 其 他 版 本 。 


人 
提 示 


对 于 本 书 中 的 示例 ， 直 接 创 建 和 编辑 .json 文 
件 。 访 文件 易于 编辑 ， 有 助 于 你 得 到 期 望 的 结 
Visual Studio 为 管理 Bower 软 件 包 提 供 了 一 个 图 形 工 
具 ， 右 击 bower.json 文 件 ， 从 弹出 的 菜单 中 选择 
Manage Bower Package 即 可 打开 该 工具 。 


表 6-2 bower.json 文 件 中 版 本 号 的 一 些 常 用 模式 


m 











3.3.7 “| 安装 与 给 定 的 版 本 号 完全 匹配 的 软件 包 ， 例 如 3.3.7 


























星 号 将 允许 Bower 下 载 和 安装 任何 版 本 的 软件 包 




















有 > 或 >= 作 为 版 本 号 的 前 级 将 允许 Bower 安 装 大 于 以 及 大 于 或 等 于 给 定 版 本 号 的 
牛 包 的 任何 版 本 
































使 用 < 或 <= 作 为 版 本 号 的 前 级 将 允许 Bower 安 装 小 于 以 及 小 于 或 等 于 给 定 版 本 号 的 
软件 包 的 任何 版 本 




















HRA 字符) 作为 版 本 号 的 前 绥 将 允许 Bower 安 装 即使 版 本 号 的 最 后 一 位 
匹配 的 版 本 。 人 例如， 指定 "3.3.7 将 允许 Bower 安 装 3.3.8 或 3.3.9 版 本 ， 但 不 
3.4.0 版 本 
























































插入 符 ARTE) 作为 版 本 号 的 前 缀 将 允许 Bower 安 装 即使 版 本 号 的 第 二 位 或 
补丁 号 不 匹配 的 版 本 。 例 如 ， 指 定 ^ 3.3.0 将 允许 Bower 安 装 3.3.1、3.4.0 和 3.5.0 版 
本 ， 但 不 可 以 安装 4.0.0 版 本 














Visual Studio 会 监控 bower.json 文 件 是 否 更 改 ， 
并 上 自动 使 用 Bower 工 具 下 载 和 安装 软件 包 。 当 把 更 
改 保 存 到 代码 清单 6-7 所 示 的 文件 时 ，Visual Studio 
将 下 载 Bootstrap 包 并 将 其 安装 到 wwwrootUlib 文 件 夹 
中 ， 如 图 6-6 所 示 。 


Solution Explorer vyox 
on -\e-sael\s—= 
Search Solution Explorer (Ctrl+)) p~ 


CED wn 
ks) W wwroot 
Gl lib 





4 
> © bootstrap 
> Ml jquery 


图 6-6 ATA Msn Pi 


怠 像 NuGet 一 样 ，Bower 可 管理 添加 到 项 目 中 
的 包 的 依赖 。 对 于 一 些 高 级 功能 ，Bootstrap 依 赖 
jQuery JavaScript 库 ， 这 就 是 为 什么 在 图 6-6 中 有 两 
个 包 。 展 开 Solution Explorer 窗 格 中 的 依赖 项 ， 束 可 
以 查看 包 及 其 依赖 项 的 列表 ， 如 图 6-7 所 示 。 


Solution Explorer 
@5-|\e-Séb|s—- 
Search Solution Explorer (Ctri+;) 
“ Dependencies 
b g Analyzers 
> 四 NuGet 


> 83 SDK 
4 Owe 


4 ül bootstrap (3.3.7) 
8-8 jquery (3.2.1) 








图 6-7 WAZ mE A RT 


2. 更 新 Bootstrap 包 





在 本 书 的 其 余部 分 ， 使 用 了 Bootstrap CSS 框 染 
的 预 发 布 版 本 。 在 撰写 本 书 时 ，Bootstrap 团 队 正 在 
FRA, FFA CAAA SILER AS. KEE 
版 本 被 标记 为 apha， 但 是 质量 很 高 ， 并 且 它 们 足够 
稳定 ， 可 以 在 本 书 的 示例 中 使 用 。 当 考虑 是 选择 使 
用 即将 过 时 的 Bootstrap 3 还 是 使 用 Bootstrap 4 的 预 发 
布 版 本 来 编写 这 本 书 时 ， 最 终 作 者 决定 使 用 新 版 
本 ， 尺 管 在 最 终 发 布 之 前 ， 用 于 设置 HTML 元 系 样 
式 的 一 些 类 名 可 能 会 更 改 。 这 意味 着 你 必须 使 用 相 
同 版 本 的 Bootstrap 包 才能 从 示例 中 获得 预期 的 结 
FR o 

















要 更 新 Bootstrap 包 ， 请 更 改 bower.json 文 件 中 
的 版 本 号， 如 代码 清单 6-8 所 示 。 


代码 清单 6-8 ”在 WorkingWithVisualStudio 文 件 夹 下 的 
bower.json 文 件 中 更 改 包 的 版 本 


— 


"name": "asp.net", 
"private": true, 
"dependencies": { 

"bootstrap": "4.0.0-alpha.6" 


} 
} 





在 保存 对 bower.json 文 件 所 做 的 更 改 时 ，Visual 
Studio 将 下 载 狐 版 的 Bootstrap 包 。 


6.3 ”和 迭代 开发 

Web 应 用 开发 通常 是 一 个 迭代 过 程 ， 可 以 对 视 
图 或 类 进行 细微 的 更 改 ， 并 运行 应 用 程序 来 测试 它 
们 的 效果 。 让 MVC 和 Visual Studio 协 同 工 作 便 可 以 
实现 这 种 迭代 并 方便 快捷 地 看 到 更 改 效果 。 





6.3.1 ”修改 Razor 视 图 


在 开 有 过程 中 ， 一 旦 收 到 来 目 浏 览 右 的 HITP 
请 求 ， 对 Razor 视 图 所 做 的 更 改 就 会 立即 生效 。 为 
了 演示 这 是 如 何 工 作 的 ， 请 从 Debug 沫 单 中 选择 


Start Debugging， 启 动 应 用 程序 ， 打 开 浏 览 器 并 显 
示 数 据 后 ， 对 Index.cshtml 文 件 所 做 的 更 改 如 代码 清 
单 6-9 所 示 。 


代码 清单 6-9 更改 Index.cshtml 文 件 





@model IEnumerable<WorkingWithVisualStudio.Models.Produ 
ct> 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Working with Visual Studio</title> 
</head> 
<body> 
<h3>Products</h3> 
<table> 
<thead> 
<tr><td>Name</td><td>Price</td></tr> 
</thead> 
<tbody> 
@foreach (var p in Model) { 
<tr> 
<td>@p.Name</td> 
<td>@($"{p.Price:C2}")</td> 
</tr> 


} 
</tbody> 


</table> 
</body> 
</html> 


将 更 改 保存 到 Index 视 图 中 ， 然 后 单 击 浏览 器 
中 的 Reload 按 钮 以 重新 加 载 当 前 网 页 。 对 视图 的 更 
改 〈 添 加 页 由 以 及 将 Price 属 性 设置 为 美元 格式 ) 将 
生效 并 显示 在 浏览 嚣 中， 如 图 6-8 所 示 。 





he ZN 


第 21 章 将 介绍 Razor 视 图 的 使 用 过 程 。 


6.3.2 ”对 C# 类 进行 更 改 


对 于 C# 类 【包括 控制 器 和 模型 )， 处 理 更 改 的 
方式 取决 于 如 何 局 动 应 用 程序 。 后 面 会 介绍 两 种 可 
用 方式 ， 可 以 通过 Debug 六 单 中 的 不 同 六 单项 进行 
选择 ， 如 表 6-3 所 示 。 





表 6-3 Debug 荣 单项 



































当 接收 到 HTTP 请 求 时 ， 项 目 中 的 类 将 自动 编译 ， 这 是 一 种 更 动态 的 
验 。 应 用 程序 在 没有 调试 器 的 情况 下 运行 ， 所 以 不 能 控制 代码 的 执行 






























































在 这 种 开发 模式 下 ， 必 须 显 式 地 编译 项 目 并 重新 启动 应 用 程序 以 使 更 改 生效 。 
调试 器 在 程序 运行 时 添加 到 应 用 程序 中 ， 这 样 可 以 检查 运行 状态 并 分 析 任 何 问 
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1. 目 动 编 详 类 


在 正音 开发 过 程 中 ， 人 快速 迭代 可 以 使 你 立即 看 
到 更 改 的 效 末 ， 无 论 是 添加 新 操作 还 是 更 改 视 岁 模 
型 选择 的 数据 都 可 以 。 对 于 此 类 开发 ， 当 浏览 器 接 
收 到 HTTP 请 求 后 ，Visual Studio 便 能 立即 检测 到 更 
改 并 自动 重新 编译 类 。 要 查看 此 操作 的 工作 方式 ， 
WM Visual Studio 的 Debug 六 单 中 选择 Start Without 
Debugging AI. EA Waren S AH A a 
对 Home 控 制 占 的 更 改 如 代码 清单 6-10 所 示 。 





代码 清单 6-10 ”在 HomeController.cs 文 件 中 筛选 模型 数据 





using Microsoft.AspNetCore.Mvc; 

using WorkingWithVisualStudio.Models; 

using System. Linq; 

namespace WorkingWithVisualStudio.Controllers { 
public class HomeController : Controller { 


public IActionResult Index() 
=> View(SimpleRepository.SharedRepository.P 


.Where(P => p.Price < 5@)); 


以 上 代码 便 用 LINQ 来 科 选 Product 对 象 ， 只 有 
Price 属 性 小 于 50 的 才能 被 传递 给 视图 。 将 更 改 保存 
到 控制 右 类 文件 并 重新 加 载 浏览 颖 窗口 ， 而 无 须 集 
止 或 重新 启动 Visual Studio 中 的 应 用 程序 。 浏 览 器 
的 HTTP 请 求 将 触发 编译 过 程 ， 应 用 程序 将 使 用 修 
改 后 的 控制 器 类 重新 启动， 从 而 产生 图 6-9 所 示 的 
结果 ， 其 中 省 略 了 表格 中 的 Kayak 产 品 。 





图 6-9 ” 目 动 编译 类 


当 一 切 都 按 计 划 进 行 的 时 候 ， 目 动 编译 功能 是 
非常 好 用 的 。 但 是 当 编 译 或 运行 过 程 中 出 现 错误 
时 ， 错 误会 直接 显示 在 浏览 器 而 不 是 Visual Studio 
中 ， 此 时 我 们 便 很 难 找 出 哪里 出 了 状况 。 例 如 ， 代 





三 清单 6-11 显 示 了 如 何 为 存储 库 中 的 模型 对 象 集合 
添加 null 引 用 。 


代码 清单 6-11 ”在 SimpleRepository.cs 文 件 中 添加 nul1 引 用 





using System.Collections.Generic; 


namespace WorkingWithVisualStudio.Models { 
public class SimpleRepository { 
private static SimpleRepository sharedRepositor 
y = new SimpleRepository(); 
private Dictionary<string, Product> products 
= new Dictionary<string, Product>(); 


public static SimpleRepository SharedRepository 
=> sharedRepository; 
public SimpleRepository() { 
var initialItems = new[] { 


new Product { Name = "Kayak", Price = 2 
75M }, 
new Product { Name = "Lifejacket", Pric 
e = 48.95M }, 
new Product { Name = "Soccer ball", Pri 
ce = 19.50M }, 
new Product { Name = "Corner flag", Pri 
ce = 34.95M } 
}; 
foreach (var p in initialItems) { 
AddProduct(p); 


products.Add("Error", null); 


public IEnumerable<Product> Products => product 
s.Values; 


public void AddProduct(Product p) => products.A 
dd(p.Name, p); 
} 


} 





Visual Studio 的 智能 感知 功能 将 突出 显示 语法 
问题 ， 但 在 应 用 程序 运行 之 前 ， 不 会 显示 null 引 用 
这 样 的 问题 。 重 新 加 载 浏 览 夯 中 的 页 面 时 才 会 编译 
SimpleRepository 类 ， 并 且 应 用 程序 会 被 重启 。 妆 
MVC 创 建 控 制 吉 类 的 实例 以 处 理 来 目 浏览 器 的 
HTTP 请 求 时 ，HomeController 构 造 函数 才 会 实例 化 
SimpleRepository 关 ， 这 将 反 过 来 答 试 处 理 在 列表 中 
添加 的 null 引 用 。null 值 会 引发 一 个 问题 ， 但 此 时 还 
不 清楚 这 个 问题 是 什么 ， 因 为 浏览 句 没 有 显示 有 用 
的 消 妃 。 














2. JAFFA es W H 


在 开发 过 程 中 ， 当 出 现 错误 时 ， 在 浏览 器 窗口 
中 显示 更 多 有 用 的 信息 会 大 有 帮助 。 可 以 通过 局 用 
开发 人 员 异 钊 页 面 来 完成 ， 我 们 需要 对 Startup 类 进 
ER EDGE 























代码 清单 6-12 ”在 Startup.cs 文 件 中 启用 开发 人 员 异 常 页 面 


using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace WorkingWithVisualStudio { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseMvcWithDefaultRoute() ; 





第 14 章 将 详细 介绍 Startup 类 的 作用 ， 但 是 现在 
只 需要 知道 调用 UseDeveloperExceptionPage 打 展 方 
法 以 设置 错误 摘 述 页 面 就 可 以 了 。 





重新 加 载 浏 览 絮 窗口 ， 目 动 编译 过 程 将 重新 生 


成 应 用 程序 ， 并 在 浏览 右 中 生成 更 有 用 的 错误 消 





息 ， 如 图 6-10 所 示 。 
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图 6-10 
浏览 器 显示 的 错误 消息 足以 解决 简单 的 问题 ， 
能 是 引起 








Kah TRAFE, AT E A A Aa 


问题 的 原因 。 但 是 ， 对 于 复杂 的 问题 或 者 那些 不 能 
需要 使 用 Visual Studio 调 试 器 。 





立即 最 现 的 问题 ， 


3. 使 用 调试 器 


Visual Studio 还 文 持 使 用 调试 如 运 行 MVC 应 用 
程序 ， 可 以 暂停 执行 以 检查 应 用 程序 的 状态 和 代码 
逻辑 规定 的 请 求 应 遵循 的 路 任 。 这 需要 使 用 不 同 的 
开发 模式 ， 因 为 在 重 狐 局 动 应 用 程序 之 前 对 C# 类 所 
做 的 修改 不 会 起 作用 《尽管 对 Razor 视 岁 所 做 的 更 
改 会 自动 生效 ) 。 





这 种 开发 方式 不 像 使 用 上 自动 编译 那样 具有 动态 
性 ， 但 是 Visual Studio 调 试 器 非常 好 用 ， 可 以 在 浏 
览 志 窗口 中 显示 信息 ， 从 而 使 开 及 人 员 对 应 用 程序 
的 工作 方式 有 更 深层 次 的 了 解 。 





要 使 用 调试 句 运 行 应 用 程序 ， 请 从 Visual 
Studio [J Debug sz * 4126 FEStart Debugging. Visual 
Studio 将 在 启动 应 用 程序 之 前 编译 项 目 中 的 C# 类 ， 
也 可 以 使 用 Build 六 单 手动 编译 代码。 











示例 应 用 程序 中 仍然 包含 null 引 用 ， 也 就 古 
说 ， 由 SimpleRepository 类 抛 出 的 未 处 理 的 
Null]ReferenceException 将 中 断 应 用 程序 并 将 执行 控 
制 传递 给 开发 人 员 ， 如 图 6-11 所 示 。 


人 
提 示 


WMR iari A RIR m> WMA Visual Studio 
的 染 单 栏 中 选择 Debug — Windows — Exception 
Settings 并 确保 Common Language Runtime 
Exceptions 列 表 中 所 有 的 并 第 类 型 都 被 检测 到 。 





图 6-11 未 处 理 的 异常 


1) RAIA 
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问题 出 现 的 地 方 。Visual Studio 高 亮 显 示 的 语句 表 
明 在 使 用 LINQ 和 萌 选 对 象 时 出 了 问题 ， 但 只 需要 做 
少量 的 工作 束 可 以 了 解 详细 信息 并 找到 根本 原因 。 








Wt (breakpoint〉 用 于 告诉 调试 器 停止 应 用 
程序 的 执行 而 转 为 手动 执行 。 可 以 检查 应 用 程序 的 
状态 ， 但 看 正在 友 生 的 情况 ， 还 可 以 选择 再 次 恢复 
执行 。 








要 创建 断 点 ， 请 右 击 代 码 语句 ， 然 后 从 弹出 的 
3 dh 26 4 Breakpoint > Insert Breakpoint。 作 为 演 
示 ， 我 们 将 断 点 应 用 于 SimpleRepository 类 中 的 
AddProduct 方 法 ， 如 图 6-12 所 示 。 





图 6-12 ”创建 断 点 


选择 Debug > Start Debugging， 启 动 应 用 程序 ， 
如 条 应 用 程序 已 经 处 于 运行 状态 ， 就 使 用 调试 闫 或 
者 选择 Debug — Restart JA MABE. ZED DEAS 
初始 化 HITP 请 求 时 ， 也 会 初始 化 SimpleRepository 
关 。 当 程序 执行 到 断 点 时 ， 束 会 停止 执行 。 








此 时 ， 可 以 使 用 Visual Studio 的 Debug 荣 单项 或 





窗口 顶部 的 控件 来 控制 应 用 程序 的 执行 ;或 者 选择 
Debug — Windows， 启 用 调试 视图 来 检查 应 用 程序 
状态 。 
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复 bug 之 前 ， 我 们 必须 弄 清楚 究竟 发 生 了 什么 ， 而 
Visual Studio 提 供 的 最 有 用 的 功能 之 一 残 是 能 够 在 
代码 编辑 磺 中 簿 看 和 监控 变量 的 值 。 








如 果 将 鼠标 指针 移动 到 变量 p 上 ， 并 移 到 调试 
器 融 有 党 显示 的 AddProduct 方 法 上 ， 束 会 弹出 一 个 窗 
口 ， 显 示 p 的 值 ， 如 图 6-13 所 示 。 





这 个 例子 可 能 不 那么 确切 ， 因 为 数据 对 象 与 断 
扩 是 在 相同 的 构造 函数 中 定义 的 ， 但 这 个 功能 适用 
于 任何 变量 。 可 以 浏览 各 个 变量 以 但 看 其 属性 和 字 
段 值 。 每 个 变量 的 右 侧 都 有 一 个 小 的 图 钉 按钮 ， 在 











代码 继续 执行 时 可 以 用 和 它 监控 变量 的 值 。 


Bl WorkingWithVisualStudio ~ | = WorkingWithVisualStudio.Models.SimpleRep ~|@ SimpleRepository( 
13 new P = "Kayak", Price = 275M }, 

= "Lifejacket", Price = 48.95M }, 

= "Soccer ball”, Price = 19.50M }, 

= "Corner flag", Price = 34.95M } 

foreach (var p in ini = = = 
AddProduct(p); 4 @ p {WorkingWithVisualStudio.Models.Product} = 

# Name & ~ "Kayak" = 
& Price 275 | 


public IEnumerable<Product> Products => products.Values; 





products.Add("Error”, 


public void AddProduct(Product 


4 @ p {WorkingWithVisualStudio.Models.Product} = 
# Name Q ~ “Kayak” =| 
# Price 25 f 





图 6-13 检查 数据 值 





g 





F be Pant EP ae fe TEE Ep EF [Al XE Product] 
用 上 ， 展 开 引 用 后 ， 还 可 以 锁定 Name 和 Price 属 
性 ， 从 而 实现 图 6-14 所 示 的 效果 。 











wll); 


products => products.Values; 


uct p) => products.Add(p.Name, p); |< me p | QWNorkingWithVisualStudio Models Product} 
# pName P - "Kayak" 
# pPrice 275 


图 6-14 在 代码 编辑 器 中 锁定 值 


从 Visual Studio 的 Debug 荣 单 中 选择 Continue 以 
继续 执行 应 用 程序 。 由 于 应 用 程序 正在 执行 foreach 
循环 ， 因 此 当 再 次 遇 到 断 点 时 将 俘 止 执行 。 被 锁定 
的 值 将 显示 pp 变量 及 其 属性 值 的 变化 ， 如 图 6-15 所 
7B 


He p {WorkingWithVisualStudio.Models.Product} | 
# p.Name P ~"Lifejacket® 
 p.Price 48.95 





图 6-15 ”监控 锁定 值 的 变化 
3) 使 用 Locals 窗 口 


Locals 窗 口 可 通过 选择 
Debug — Windows = Locals $. WX} FF. Locals fi 
HWAW TBE EW 7 ce NB, (AN 
所 有 与 断 点 相关 的 本 地 对 象 ， 如 图 6-16 所 示 。 











图 6-16 ”Locals 窗 口 


每 次 选择 Debug -Continue 时 ， 应 用 程序 束 会 
继续 执行 ， 下 一 个 对 象 将 由 foreach 循 坏处 理 。 如 果 
一 页 继续 下 去 ， 束 会 看 到 null 引 用 出 现 ， 在 Locals 徐 
口中 也 可 以 看 到 。 窗 口 和 锁定 的 值 显 示 在 代码 编辑 
器 中 。 通 过 使 用 调试 器 控制 应 用 程序 的 执行 ， 可 以 
跟 踊 代码 的 流程 并 了 解 正在 发 生 的 事情 。 





我 们 可 以 通过 清理 Product 对 象 的 集合 来 修复 
null 引 用 问题 ， 还 可 以 选择 另 一 种 方法 来 使 控制 器 
更 加 健壮 ， 如 代码 清单 6-13 所 示 ， 这 里 使 用 了 null 
条 件 运 算 符 来 检查 null 值 (如 第 4 章 所 述 〉。 





代码 清单 6-13 在 HomeController.cs 文 件 中 解决 nul 引 用 问题 


using Microsoft.AspNetCore.Mvc; 


using WorkingWithVisualStudio.Models; 
using System.Ling; 


namespace WorkingWithVisualStudio.Controllers { 
public class HomeController : Controller { 
public IActionResult Index() 


=> View(SimpleRepository.SharedRepository.P 
roducts 


.Where(P => p?.Price < 5@)); 
} 





要 葵 用 上 断 点 ， 可 右 击 已 应 用 断 点 的 代码 语句 ， 
并 从 弹出 的 菜单 中 选择 Delete Breakpoint。 重 新 启 
动 应 用 程序 ， 你 将 看 到 图 6-17 所 示 的 人 简单 数据 表 。 








[D Working with Visual Stuc X 


S | © locathost:64405 


Products 


Name ice 

Lifejacket £48.95 
Soccer ball £19.50 
Comer flag £34.95 





图 6-17 ”修复 错误 


与 那些 需要 使 用 错误 扫描 软件 才能 解决 的 问题 
相 比 ， 这 个 问题 比较 简单 ， 但 是 Visual Studio 调 试 


硕 是 非常 好 用 的 ， 通 过 使 用 应 用 程序 的 各 种 可 视 化 
rana., 我 们 可 以 真正 挖掘 到 错误 的 
ANT o 


6.3.3 ”使 用 浏览 器 链接 


浏览 器 链接 (browser link) 功能 可 以 通过 将 一 
个 或 多 个 浏览 器 置 于 Visual Studio 的 控制 之 下 来 简 
化 开发 过 程 。 尤 其 是 在 需要 查看 一 系列 浏览 器 的 更 
改 效果 时 ， 这 项 功能 最 有 用 。 浏 览 颖 链接 在 使 用 类 
的 目 动 编译 功能 时 非常 有 效 ， 因 为 它 可 以 用 来 修改 
项 目 中 的 任何 文件 ， 并 显示 更 改 的 效果 ， 而 不 必 切 
换 到 浏览 右 并 手动 重新 加 载 页 面 。 





- WAN W ai EPR 


启用 浏览 器 链接 需要 对 Startup 类 进行 配置 更 
改 ， 如 代码 清单 6-14 所 示 。 


using 
using 
using 
using 
using 
using 
using 
using 


代码 清单 6-14 在 workingWithVisualStudio 文 件 夹 下 的 
Startup.cs 文 件 中 局 用 浏览 器 链接 


System; 

System.Collections.Generic; 

System. Ling; 

System. Threading.Tasks; 
Microsoft.AspNetCore. Builder; 
Microsoft.AspNetCore.Hosting; 
Microsoft.AspNetCore.Http; 
Microsoft.Extensions.DependencyInjection; 


namespace WorkingWithVisualStudio { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 


n services) { 


services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseBrowserLink() ; 
app.UseMvcWithDefaultRoute() ; 





2. (EHDI bh ai HE Bc 


要 了 解 浏览 器 链接 的 工作 方式 ， 请 从 Visual 
Studio 的 Debug 荣 单 中 选择 Start Without 
Debugging. Visual Studio 将 启动 应 用 程序 并 打开 新 
的 浏览 器 选项 卡 以 显示 结 末 。 查 看 友 送 到 浏览 器 有 的 
HTML， 你 将 看 到 其 中 包含 一 块 附加 的 内 容 ， 如 下 
FAR: 











<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/ > 
<title>Working with Visual Studio</title> 
</head> 
<body> 
<h3>Products</h3> 
<table> 
<thead> 
<tr><td>Name</td><td>Price</td></tr> 
</thead> 
<tbody> 
<tr><td>Lifejacket</td><td>£48.95</td>< 
/tr> 
<tr><td>Soccer ball</td><td>£19.50</td> 
</tr> 
<tr><td>Corner flag</td><td>£34.95</td> 
</tr> 
</tbody> 
</table> 


<!-- Visual Studio Browser Link --> 
<script type="application/json" id="__browserLink_initi 
alizationData"> 
{"requestId" :"968949d8affc47c4a9c6326de21dfae3","re 
questMappingFromServer": false} 
</script> 
<script type="text/javascript" 
src="http://localhost :55356/d1a038413c804e178efee09a 
3be07b262/browserLink" 
async="async"> 
</script> 
<!-- End Browser Link --> 
</body> 
</html> 





o 


je ” 示 


如 果 没 有 看 到 附加 部 分 ， 请 从 图 6-18 所 示 的 菜 
单 中 选择 Enable Browser Link 并 重新 加 载 浏 览 器 。 


Visual Studio 会 将 一 对 script 元 素 添 加 到 发 送 到 
浏览 右 的 HTML 中 ， 以 打开 一 个 具有 较 长 生命 周期 
的 HTTP 连 接 并 返回 给 应 用 程序 服务 强 ， 以 便 Visual 
Studio 可 以 要 求 浏览 右 重 新 加 载 页 面 。 如 果 Sscript 元 
系 不 显示 ， 请 检查 以 确保 在 图 6-18 所 示 的 六 时 中 选 
择 了 Enable Browser Link 选 项 。 代 人 码 清 单 6-15 显 示 
了 对 Index 视 图 所 做 的 更 改 ， 并 演示 了 使 用 浏览 融 链 
接 的 效果 。 





代码 清单 6-15“” 癌 Index.cshtml 文 件 添 加 一 个 时 间 戳 





@model IEnumerable<WorkingWithVisualStudio.Models.Produ 
ct> 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Working with Visual Studio</title> 
</head> 
<body> 
<h3>Products</h3> 
<p>Request Time: @DateTime.Now. ToString("HH:mm:ss") 
</p> 


<table> 


<thead> 
<tr><td>Name</td><td>Price</td></tr> 
</thead> 
<tbody> 
@foreach (var p in Model) { 
<tr> 
<td>@p.Name</td> 
<td>@($"{p.Price:C2}")</td> 
</tr> 
} 
</tbody> 
</table> 
</body> 
</html> 





保存 对 视图 文件 所 做 的 更 改 ， 并 从 Visual 
Studio 工 具 栏 的 Browser Link 4." vt% Refresh 
Linked Browsers， 如 图 6-18 所 示 。 如 果 浏 览 器 链接 
不 起 作用 ， 请 答 试 重新 加 载 浏览 器 或 重新 局 动 
Visual Studio Jf Œi o 


-ew 
Tools Test CodeMaid Analyze Window Help 


- Any CPU -~ > IIS Express ~ O~ pa 
© Refresh Linked Browsers Ctrl+Alt+Enter 
B Browser Link Dashboard 

V Enable Browser Link 

V Enable CSS Auto-Sync 












图 6-18 ”使 用 浏览 融和 链接 重新 加 载 浏 贤 


发 送 到 浏览 器 的 舱 入 HTML 中 的 JavaScript 代 码 
将 重新 加 载 页 面 ， 显 示 最 终 的 效果 一 一 添加 了 一 个 
简单 的 时 间 惟 。 每 次 选择 Visual Studio 采 单项 时 ， 
浏览 器 都 会 对 服务 器 发 出 一 个 新 的 请 求 。 这 个 请 求 
会 使 Ihdex 视 图 生成 一 个 新 的 共有 更 新 时 间 惟 的 
HTML 页 面 。 


YO 
v> A 
YE E 


浏览 器 链接 的 Script 元 素 仅 在 成 功 的 啊 应 中 才 会 
能 入 ， 也 残 是 说 ， 如 末 在 = 革 闫 文件、 呈现 Razor 
视图 或 处 理 请 求 时 发 生 开 币 ， 浏 览 器 和 Visual 
Studio 之 则 的 连 ee 并 且 一 旦 解决 了 问 





题 ， 融 必须 使 用 浏览 郁 重 新 加 载 页 面 。 


3. EH Z wl bi as 








浏览 器 链接 可 用 于 在 多 个 浏览 器 中 同时 显示 应 
用 程序 ， 这 项 功能 在 你 希望 解除 浏览 器 之 间 的 实现 
差异 《特别 是 在 实现 目 定 义 CSS 样 式 表 时 ) 或 得 看 
应 用 程序 如 何在 果 面 浏览 项 和 移动 浏 贞 右 的 组 合 中 
呈现 时 很 有 用 。 








要 选取 浏览 器 ， 请 从 Visual Studio 工 具 栏 的 IIS 
Express 下 拉 荣 单 中 选择 Browse With 选 项 ， 如 图 6- 
19 所 示 。 





图 6-19 ”选择 多 浏览 


Visual Studio 会 显示 它 所 知道 的 浏览 器 的 列 
表 。 图 6-20 显 示 了 作者 系统 中 安装 的 浏览 器 ， 其 中 
一 些 是 Windows 操 作 系 统 自 禹 的 (比如 Internet 
M ， 夯 一 些 是 作者 自己 安装 的 第 用 
浏览 





Visual Studio 会 在 安装 过 程 中 碍 找 常 用 的 浏览 
器 ， 你 也 可 以 使 用 Add 按 钮 来 设置 未 自动 发 现 的 浏 
哆 器 。 你 还 可 以 设置 浏览 器 栈 这 样 的 第 三 方 测试 工 
具 ， 通 过 将 浏览 器 运行 在 云 托管 的 虚拟 机 上 ， 实 现 
了 不 必 人 工 管 理 大 型 的 操作 系统 和 浏览 器 矩阵 就 可 
以 进行 测试 。 





Browsers (select one or more): 


Firefox | 
Secale Chrome : 
> Remove 


Internal Web Browser 





Size of browser window: Default 3 “3| 








图 6-20 ”从 列表 中 选取 浏览 器 


这 里 选择 了 Google Chrome 
Canary (Default) ~ Internet Explorer 和 Microsoft 
Edge 浏 览 器 。 单 击 Browse 按 钮 将 启动 这 3 种 浏览 
硕 ， 并 使 它们 加 载 示 例 应 用 程序 的 URL， 如 图 6-21 
所 示 。 










wi 
Products 
Request Time: 13:18:34 
Request Time: 13:18:34 













Name Name Price 
Lifejacket £48.95 Name Price 8.95 
Soccer ball £19.50 Lifejacket £48.95 a our £19.50 

‘omer flag £34.95 g £34.95 











图 6-21 ”使 用 多 浏览 器 


可 以 通过 选择 Browser Link Dashboard $% I X 
丛 看 浏览 万 链接 的 管理 情况 ， 这 将 打开 图 6-22 上 所 示 
的 窗口 ， 其 中 显示 了 每 个 浏览 器 输出 的 是 哪个 URL 
的 内 容 ， 每 个 浏览 器 都 可 以 单独 刷新 。 


Browser Link Dashboard 





4 WorkingWithVisualStudio (3 connections) 


4 Connections 
Chrome + ~ 
Microsoft Edge v ~/ 


Mozilla ~ 








图 6-22 Browser Link Dashboard‘ O 
6.4 部署 JavaScript 和 CSS 


在 创建 Web 应 用 程序 的 客户 端 部 分 时 ， 通 单 会 
创建 许多 自 定义 的 JavaScript 和 CSS 文 件 ， 它 们 用 于 
补充 由 Bower 安 装 的 包 。 这 些 文件 需要 进行 处 理 以 
优化 它们 在 生产 环境 中 的 传递 速率 ， 从 而 最 大 限度 
地 减少 HTTP 请 求 的 数量 以 及 将 它们 传送 到 客户 并 





所 需 的 网 络 带宽 。 本 节 将 介绍 微软 为 执行 这 项 任务 
而 提供 的 VisualStudio 扩 展 。 


6.4.1 启用 静态 内 容 传 递 








ASP.NET Core 允 许 从 wwwroot 文 件 夹 问 客户 端 
提供 静态 文件 ， 但 古 当 使 用 Empty 模 板 创 建 项 目 
时 ， 默 认 情 况 下 这 是 不 允许 的 。 可 通过 将 代码 清单 
6-16 所 示 的 语句 添加 到 Startup 类 中 来 启用 对 静态 文 
件 的 文 持 。 


代码 清单 6-16 ”在 WorkingWithVisualStudio 文 件 夹 下 的 
Startup.cs 文 件 中 启用 对 静态 文件 的 支持 








using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace WorkingWithVisualStudio { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseBrowserLink() ; 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 





6.4.2 ”为 项 目 添 加 静态 内 容 


为 了 演示 打包 和 缩小 化 处 理 过 程 ， 我 们 需要 在 
项 目 中 添加 一 些 静态 内 容 ， 并 使 其 具备 交付 给 客户 
端的 能 力 。 首 先 ， 创 建 wwwrootcss 文 件 光 ， 这 是 存 
储 自 定 义 CSS 文 件 的 地 方 。 然 后 ， 使 用 Style Sheet 
模板 添加 名 为 first,css 的 文件 ， 如 图 6-23 所 示 。Style 
Sheet 模 板 位 于 ASP.NET Core > Web — Content 部 


pie 





Add New Item - WorkingWithVisualStudio 








4 Installed Sort by: {Default -| ea 
4 ASP.NET Core Tyi A. 
Se Ji HTML Page ASP.NET Core i Pg 
General 
4 Web 
ASP.NET = Cai 
23] LESS Style Sheet ASP.NET Core 
General # 
oa a 滞 SCSS Style Sheet (SASS) ASP.NET Core 2 
Content ES i 
4 
b Onl 4 
Name: first. 4 


图 6-23 ”添加 first.css 


编辑 first.css 文 件 以 添加 代码 清单 6-17 所 示 的 
CSS 样 式 。 


代码 清单 6-17 wwwroot/css 文 件 夹 下 的 first.css 文 件 的 内 容 


h3 { 
font-size: 18pt; 
font-family: sans-serif; 


} 
table, td { 


border: 2px solid black; 
border-collapse:collapse; 
padding: 5px; 
font-family: sans-serif; 





重复 上 述 过 程 ， 在 wwwroot/css 文 件 夹 中 创建 


男 一 个 样式 表 ， 名 为 second.css， 如 代码 清单 6-18 所 


小。 


代码 清单 6-18 wwwroot/css 文 件 夹 下 的 second.css 文 件 的 内 容 


font-family: sans-serif; 
font-size: 10pt; 
color: darkgreen; 


background-color: antiquewhite; 
border: 1px solid black; 
padding: 2px; 





目 定 义 的 JavaScript 文 件 存储 在 wwwrooUjs 文 件 
夹 中 。 使 用 JavaScript File 模 板 创建 名 为 third.js 的 文 
件 ， 如 图 6-24 所 示 。 





g 
serif 
G 1 TS 
P EEr Ej TypeScript File ASP.NET Core j 
ASP.NET -Ts 
cena [E] TypeScriptsx Fite ASP.NET Core ; 
Senp f J TypeScript JSON Configuration File ASP.NET Core 
Content Q. # 
JS 
rj JSX File ASP.NET Core a 
oy 
[Â] ngularjs Controller SP.NET C P 
B Angulars Controller usin g Sscope ASP.NET Core # 
£ 
B AngularJs Directive ASP.NET C i 
Name: hirdj J 


图 6-24 ”创建 一 个 JavaScript 文 件 


在 third.js 文 件 中 添加 一 些 简单 的 JavaScript 代 
码 ， 如 代码 清单 6-19 所 示 。 


代码 清单 6-19 ” wwwroot/js 文 件 夹 下 的 third.js 文 件 的 内 容 


document.addEventListener("DOMContentLoaded", function 


O { 
var element = document.createElement("p"); 
element.textContent = "This is the element from the 


third.js file"; 
document. querySelector("body").appendChild(element) 





+); 


这 里 还 需要 另外 一 个 JavaScript 文 件 。 在 
wwwroot/js 文 件 夹 中 创建 fourth.js 文 件 ， 在 其 中 添加 
代码 清单 6-20 所 示 的 代码 。 


代码 清单 6-20 ” wwwroot/js 文 件 夹 下 的 fourth.js 文 件 的 内 容 





document.addEventListener("DOMContentLoaded", function 


O { 
var element = document.createElement("p"); 
element.textContent = "This is the element from the 


fourth.js file"; 
document. querySelector("body").appendChild(element) 


] ) 





6.4.3 ”更 新 视图 


最 后 的 准备 步骤 是 更 新 Index.cshtml 文 件 以 使 用 
新 的 CSS 样 式 表 和 JavaScript 文 件 ， 如 代码 清单 6-21 
所 示 。 


代码 清单 6-21 为 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 添 
加 script 和 ]ink 元 素 





@model IEnumerable<WorkingWithVisualStudio.Models.Produ 
ct> 


@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Working with Visual Studio</title> 
<link rel="stylesheet" href="css/first.css" /> 
<link rel="stylesheet" href="css/second.css" /> 
<script src="js/third.js"></script> 
<script src="js/fourth.js"></script> 
</head> 


<body> 
<h3>Products</h3> 
<p>Request Time: @DateTime.Now. ToString("HH:mm:ss") 
</p> 
<table> 
<thead> 
<tr><td>Name</td><td>Price</td></tr> 
</thead> 
<tbody> 
@foreach (var p in Model) { 
<tr> 
<td>@p.Name</td> 
<td>@($"{p.Price:C2}")</td> 
</tr> 


} 
</tbody> 
</table> 
</body> 
</html> 





如 果 运 行 示 例 应 用 程序 ， 你 将 看 到 图 6-25 所 示 
的 内 容 。 现 有 内 容 中 已 添加 了 CSS 样 式 ，JavaScript 
代码 中 也 添加 了 新 内 容 。 











图 6-25 ”运行 示例 应 用 程序 


6.4.4 MVC 应 用 程序 中 的 打包 和 缩小 


目前 共有 4 个 静态 文件 ， 所 以 浏览 如 必须 及 出 4 
次 请 求 才能 获得 这 些 静 态 文 件 ， 而 且 请 求 这 些 文件 
中 的 任何 一 个 都 比 回 客 户 冯 传 递 信息 占用 的 融 宽 要 
大 ， 因 为 它们 包含 了 许多 只 对 开发 人 员 有 意义 但 对 
浏览 此 没 有 意义 的 空 晶 字符 和 变量 名 。 


合并 相同 类 型 的 文件 称 为 打包 。 使 文件 变 小 称 
为 缩小 。 这 两 个 任务 都 是 由 Visual Studio 的 Bundle 
& Minifier 扩 展 在 ASP.NET Core MVC 应 用 程序 中 执 


行 的 。 
1. FÆ Visual Studio 扩 展 


第 一 步 是 安装 扩展 。 选 择 Tools > Extensions 
and Updates 沫 单项 ， 然 后 单 击 Online 类 别 以 显示 可 
用 的 Visual Studio 扩 展 库 。 在 窗口 右上 角 的 搜索 杠 
中 输入 Bundler & Minifier， 如 图 6-26 所 示 。 找 到 
Bundler & Minifier 扩 展 ， 然 后 单 击 Download 按 钮 将 
其 添加 到 Visual Studio 。 完 成 安 闭 并 重新 司 动 


Visual Studio 。 





Scheduled For Install: 














图 6-26 ”找到 Visual Studio 扩 展 


2. 打包 和 缩小 文件 


一 旦 安装 Bundler & Minifier 扩 展 并 重新 启动 
Visual Studio， 残 可 以 选择 同一 类 型 的 多 个 文件 ， 
将 它们 打包 在 一 起 并 缩小 它们 的 内 容 。 例 如 ， 在 
Solution Explorer 窗 格 中 选择 first.css 和 second.css 文 
件 ， 石 击 后 ， 从 弹出 的 采 单 中 选择 Bundler & 
Minifier > Bundle and Minify Files， 如 图 6-27 所 示 。 





图 6-27 打包 和 缩小 CSS 文 件 


将 输出 文件 另存 为 bundle.css，Bundler & 
Minifier 扩 展 将 处 理 这 个 CSS 文 件 。Solution Explorer 


窗 格 中 将 显示 新 的 bundle.css 文 件 ， 可 以 展开 它 以 显 
示 bundle.min.css 压 缩 文件 。 打 开 这 个 压缩 文件 后 ， 
你 将 看 到 两 个 独立 的 CSS 文 件 的 内 a CRA, FF 
HAWE AB AR. PRAY BE ANS Be 
用 这 个 文件 ， 但 它 非 常 小， 只 ea 车 接 
束 能 将 CSS 样 式 传 递 给 客户 端 。 








对 third.js 和 fourth.js 文 件 重 复 这 个 过 程 ， 在 
wwwroot/js 文 件 夹 中 创建 bundle.js 和 bundle.min.js 文 
件 (60) 





Ms 
Of 


E BFAD E AIER ANT I a PE F, 
以 保留 输出 文件 中 的 样式 或 代码 语句 的 顺序 。 例 


如 ， 在 选择 fourth.js 文 件 之 前 ， 请 确保 选择 了 third.js 
文件 ， 以 确保 代码 按 正 确 的 顺序 执行 。 


在 代码 清单 6-22 中 ， 已 将 单独 文件 的 link 元 素 
符 换 为 Index.cshtml 文 件 中 请 求 打包 和 缩小 文件 的 元 
系 。 


代码 清单 6-22 ”在 Index.cshtml 文 件 中 使 用 打包 和 压缩 的 文件 








@model IEnumerable<WorkingWithVisualStudio.Models.Produ 
ct> 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Working with Visual Studio</title> 
<link rel="stylesheet" href="css/bundle.min.css" /> 
<script src="js/bundle.min.js"></script> 
</head> 
<body> 
<h3>Products</h3> 
<p>Request Time: @DateTime.Now. ToString("HH:mm:ss") 


</p> 
<table> 
<thead> 
<tr><td>Name</td><td>Price</td></tr> 
</thead> 
<tbody> 
@foreach (var p in Model) { 
<tr> 
<td>@p.Name</td> 
<td>@($"{p.Price:C2}")</td> 
</tr> 


} 
</tbody> 
</table> 
</body> 
</html> 





运行 应 用 程序 ， 虽 然 不 会 有 任何 可 视 化 的 更 
改 ， 但 打包 和 压缩 的 文件 已 经 癌 浏 览 硕 提供 了 在 单 
独 的 文件 中 定义 的 所 有 样式 和 代码 。 


在 执行 打包 和 缩小 操作 时 ，Bundler & Minifier 
扩展 会 将 文件 的 处 理 记录 在 bundleconfig.json 文 件 中 
并 保存 在 项 目的 根 目 录 下 。 下 面 是 为 示例 应 用 程序 
中 的 文件 生成 的 配置 : 


| 


{ 
“outputFileName": "“wwwroot/css/bundle.css", 
“inputFiles": [ 
"wwwroot/css/first.css", 
"wwwroot/css/second.css" 


J> 
{ 


“outputFileName": "“wwwroot/js/bundle.js", 
“inputFiles": [ 
“wwwroot/js/third.js", 
“wwwroot/js/fourth. js" 





Bundler & Minifier 扩 展 将 目 动 监控 输入 文件 的 
更 改 ， 并 在 发 生 更 改 时 重新 生成 输出 文件 ， 以 保证 
所 做 的 任何 编辑 都 反映 在 打包 和 缩小 的 文件 中 。 作 
为 演示 ， 代 码 清 单 6-23 显 示 了 对 third.js 文 件 所 做 的 
更 改 。 


代码 清单 6-23 ”third.js 文 件 中 的 改动 





document.addEventListener("DOMContentLoaded", function 
() { 
var element = document.createElement("p"); 
element.textContent = "This is the element from the 


(modified) third.js file"; 
document. querySelector("body").appendChild(element) 


] ) 





保存 文件 后 ，Bundler & Minifier 扩 展 将 重新 生 
成 bundle.min.js 文 件 。 如 果 重 新 加 载 浏 览 句 ， 你 将 
看 到 图 6-28 所 示 的 更 改 效 果 。 














图 6-28 ”打包 和 缩小 的 文件 中 的 更 改 检测 
6.5 ”小 结 


本 章 介 绍 了 人 MVC 项 目的 结构 ， 描 述 了 两 个 可 
用 的 .NET 运 行 时 功能 ， 以 及 Visual Studio WebM 
用 开发 提供 的 一 些 功能 ， 包 括 自 动 类 编译 、 浏 览 器 


链接 以 及 打包 和 缩小 。 下 一 章 将 介绍 ASP.NET Core 
MVC 项 目 是 如 何 进 行 单 元 测试 的 。 


第 7 章 ” 对 MVC 应 用 程序 进行 单元 测 
ik 


本 章 演 示 如 何 对 MVC 应 用 程序 进行 单元 测 
试 。 单 元 测试 是 一 种 测试 形式 ， 由 于 其 中 的 单个 组 
件 已 与 应 用 程序 的 其 他 部 分 隔离 ， 因 此 可 以 彻底 验 
证 其 行为 。ASP.NET Core MVC 已 设计 为 便于 创建 
单元 测试 ，Visual Studio 为 各 种 单元 测试 框架 提供 
了 文 持 。 本 章 展 示 如 何 设置 单元 测试 项 目 ， 说 明 如 
何 安装 最 流行 的 测试 框架 之 一 ， 并 描述 编写 和 运行 
测试 的 过 程 。 表 7-1 总 结 了 本 章 要 完成 的 操作 。 








表 7-1 本 章 要 完成 的 操作 











创建 单元 测 斌 项目， 安装 一 个 测试 包 ， 添 加 包 | 代码 清单 7-5 和 代 








创建 单元 测试 








含 测 试 的 类 马 清单 7-6 





为 单元 测试 隔离 组 件 “| 使 用 接口 分 离 应 用 程序 组 件 ， 在 单元 测试 中 使 | 代码 清单 7-7 一 代 
用 带 有 受 限 测试 数据 的 伪 实 现 码 清单 7-14 





对 不 同 的 数据 值 运行 ”| 使 用 参数 化 的 单元 测试 ， 也 可 通过 方法 或 属性 | 代码 清单 7-15 一 
同样 的 单元 测试 获取 测试 数据 代码 清单 7-17 





码 清单 7-18 和 
创建 伪 测 试 对 象 使 用 mocking 框 架 ee F 
代码 清单 7-19 


次 定 是 售 进 行 单元 测试 





能 够 简单 地 进行 单元 测试 是 使 用 ASP.NET Core 
MVC 的 优势 之 一 ， 但 这 不 适用 于 所 有 人 。 








作者 喜欢 蛙 元 测试 ， 经 党 在 自己 的 项 目 中 使 用 
单元 测试 ， 但 不 是 所 有 的 项 目 ， 并 且 也 不 像 你 所 预 
期 的 那样 。 作 者 会 专门 为 特性 和 功能 编写 单元 测 
试 ， 它 们 难以 编写 ， 而 且 很 可 能 是 部 著 中 bug 的 来 
源 。 在 这 种 情况 下 ， 单 元 测试 有 助 于 确立 那些 重要 
的 想法 。 仅 仅 测 试 需要 实现 的 东西 ， 可 以 帮助 处 理 





关于 潜在 问题 的 想法 ， 这 应 该 发 生 在 开始 处 理 实际 
的 bug 之 前 。 


也 就 是 说 ， 单 元 测试 是 一 种 工具 ， 只 有 你 才 知 
站 需要 执行 多 少 测试 。 如 宁 没 有 发 现 单 元 测试 的 好 
处 ， 或 者 有 更 适合 的 方法 论 ， 那 就 不 要 因为 单元 测 
WIN MHA Ce, MRA BENT, 
并 且 根 本 没有 执行 测试 ， 那 么 你 可 能 会 让 用 户 友 现 
bug， 这 非常 不 理想 。 你 不 作 做 单元 测试 ， 但 是 你 
真 的 需要 考虑 做 一 些 其 他 测试 〉。 








如 果 以 前 没有 接触 过 单元 测试 ， 那 么 鼓励 你 党 
试 一 下 ， 看 看 它 是 如 何 工 作 的 。 如 果 你 不 是 单元 测 
试 的 粉丝 ， 那 么 可 以 跳 过 本 章 ， 继 续 进 入 第 8 章 ， 
在 那里 构建 更 现实 的 MVC 应 用 程序 。 











7.1 准备 示例 项 目 


本 章 将 继续 使 用 你 在 第 6 草 中 创建 的 项 目 。 对 
于 本 章 ， 将 在 仓储 中 放 加 新 的 Product 对 象 以 添加 文 


FF 





7.1.1 局 用 内 置 的 标签 助手 





本 章 使 用 内 置 的 标签 助手 为 链接 元 系 设 置 href 
属性 。 本 书 将 在 第 23 一 25 章 说 明 标 签 助手 是 如 何 工 
作 的 。 为 了 简单 地 局 用 它们 ， 可 右 击 Views 文 件 
夹 ， 从 弹出 的 采 单 中 选择 Add New Item， 然 后 从 
ASP.NET 类 别 中 选择 MVC View Imports Page 项 目 模 
板 ， 创 建 一 个 视图 导入 文件 ，Visual Studio 将 目 动 
设置 文件 名 为 _-ViewImports.cshtml， 然 后 单 击 Add 
按钮 ， 添 加 代码 清单 7-1 所 示 的 代码 。 











代码 清单 7-1 _ Views 文件 夹 下 的 _ViewImports.cshtml 文 件 的 内 


IP 


AS 


@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 











以 上 语句 将 启用 内 置 的 标签 助手 ， 包 括 你 很 快 
要 在 index 视 图 中 使 用 的 标签 助手 。 可 以 还 加 using 
语句 ， 从 项 目 中 导入 命名 空间 ， 但 是 Index 视 图 不 是 
本 间 中 示例 应 用 程序 的 重要 部 分 ， 并 且 使 用 命名 空 
间 引 用 模型 类 型 也 不 是 问题 。 


7.1.2 ”为 控制 器 添加 操作 方法 


第 一 步 是 为 Home 控 制 器 添加 操作 方法 ，Home 
控制 器 用 来 演 染 通过 浏览 颖 输入 和 接收 数据 的 视 
图 ， 如 代码 清单 7-2 所 示 。 这 些 操 作 方 法 遵循 你 第 2 
章 使 用 过 的 模式 ， 第 17 章 将 详细 说 明 这 些 模 式 。 


代码 清单 7-2” 在 Controller 文 件 夹 下 的 HomeController.cs 文 件 中 
添加 操作 方法 





using Microsoft.AspNetCore.Mvc; 

using WorkingWithVisualStudio.Models; 

using System.Ling; 

namespace WorkingWithVisualStudio.Controllers { 
public class HomeController : Controller { 


SimpleRepository Repository = SimpleRepository. 
SharedRepository; 


public IActionResult Index() => View(Repository 
.Products 


.Where(P => p?.Price < 5@)); 


[HttpGet ] 
public IActionResult AddProduct() => View(new P 
roduct()); 


[HttpPost ] 

public IActionResult AddProduct(Product p) { 
Repository .AddProduct(p) ; 
return RedirectToAction("Index") ; 





7.1.3 创建 数据 输入 表单 


为 允许 用 户 创 建 狐 的 产品 ， 在 Views/Home 文 
件 夹 中 创建 名 为 AddProduct.cshtml 的 Razor 视 图 ， 并 
且 与 Home 控 制 右 中 的 AddProduct 方 法 所 呈现 的 视图 
一 样 ， 谭 循 默认 的 文件 名 和 位 置 约定 。 代 码 清单 7- 
3 展示 了 新 视图 的 内 容 ， 它 基于 你 在 第 6 章 使 用 








Bower 加 入 项 目的 Bootstrap CSS 包 。 


代码 清单 7-3 ”Views/Home 文 件 夹 下 的 AddProduct.cshtml 文 件 
的 内 容 





@model WorkingWithVisualStudio.Models.Product 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Working with Visual Studio</title> 
<link rel="stylesheet" href="/lib/bootstrap/dist/cs 
s/bootstrap.min.css" /> 
</head> 
<body class="p-2"> 
<h3 class="text-center">Create Product</h3> 
<form asp-action="AddProduct" method="post" > 
<div class="form-group"> 
<label asp-for="Name">Name:</label> 
<input asp-for="Name" class="form-control" 


/> 
</div> 
<div class="form-group"> 
<label asp-for="Price">Price:</label> 
<input asp-for="Price" class="form-control" 
/> 


</div> 
<div class="text-center"> 
<button type="submit" class="btn btn-primar 


y">Add</button> 
<a asp-action="Index" class="btn btn-second 
ary" >Cancel</a> 
</div> 
</form> 
</body> 
</html> 





该 视图 包含 一 个 HTML 表单 ， 其 使 用 HTTP 
POST 请 求 发 送 Name 和 Price 值 到 Home 控 制 器 的 
AddProduct 操 作 方 法 。 内 容 已 使 用 Bootstrap CSS 包 
EIT 


7.1.4 更 新 Index 视 网 


最 后 的 准备 步骤 是 更 新 mdex 视 图 ， 以 便 包含 
到 新 表单 的 链接 ， 如 代码 清单 7-4 所 示 。 这 里 还 借 
此 机 会 删除 了 你 在 上 一 章 中 使 用 的 JavaScript 文 件 ， 
使 用 Bootstrap 葵 换 了 目 定 义 的 CSS 样 式 表 ， 并 应 用 
于 视图 中 的 HTML 元 素 。 





代码 清单 7-4 ”更 新 Yiews/Home 文 件 夹 下 的 Index.cshtml 文 件 的 


内 容 





@model IEnumerable<WorkingWithVisualStudio.Models.Produ 
ct> 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Working with Visual Studio</title> 
<link rel="stylesheet" href="/1ib/bootstrap/dist/cs 
s/bootstrap.min.css" /> 
</head> 
<body class="p-1"> 
<h3 class="text-center">Products</h3> 
<table class="table table-bordered table-striped"> 


<thead> 
<tr><td>Name</td><td>Price</td></tr> 
</thead> 
<tbody> 
@foreach (var p in Model) { 
<tr> 
<td>@p.Name</td> 
<td>@($"{p.Price:C2}")</td> 
</tr> 
} 
</tbody> 
</table> 


<div class="text-center"> 
<a class="btn btn-primary" asp-action="AddProdu 
ct"> 
Add New Product 


</a> 
</div> 
</body> 
</html> 


如 果 运 行 示例 应 用 程序 ， 你 将 会 看 到 新 装饰 的 
内 容 和 Add New Product 按 钮 ， 用 于 引导 到 数据 输入 
表 蛙 。 如 果 提 交 表 单 ， 将 添加 新 的 Product 对 象 到 存 
储 库 中 ， 并 重 定 同 浏览 器 以 便 初始 的 应 用 程序 视图 
被 展示 出 来 ， 如 图 7-1 所 示 。 








二 


he ” 示 








切记 此 例 中 的 存储 库 仅 仅 在 内 存 中 存储 对 象 ， 
这 意味 着 在 应 用 程序 重新 启动 之 时 ， 创 建 的 任何 新 
产品 都 将 被 丢弃 。 














图 7-1 运行 示例 应 用 程序 


7.2 ”测试 MVC 应 用 程序 


单元 测试 用 于 验证 应 用 程序 中 独立 组 件 的 行为 
和 特性 ，ASP.NET Core 和 ASP.NET Core MVC 被 设 
计 为 尽 可 能 为 Web 应 用 程序 设置 和 运行 单元 测试 。 
本 节 将 说 明 如 何在 Visual Studio 中 设置 单元 测试 ， 
并 演示 如 何 为 MVC 应 用 程序 编写 单元 测试 ， 还 将 介 
绍 一 些 使 得 单元 测试 更 为 简单 和 可 徘 的 有 用 工具 。 








有 多 种 单元 测试 包 可 用 ， 本 书 中 使 用 的 名 为 
xUnit.net， 它 与 Yisual Studio 能 够 民 好 集成 ， 可 用 来 


为 ASP.NET 编 写 单元 测试 。 表 7-2 介 绍 了 xUnit.net 的 


Ab Æ. 
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表 7-2 ”xUnit.net 的 背景 


xUnit.net 


是 什 XUnit.net 是 单元 测试 框架 ， 可 以 用 来 测试 ASP.NET Core MVC 应 用 程 















































xUnit.net 是 编写 良好 的 测试 框架 ， 可 以 很 容易 集成 到 Visual Studio4 


























测试 被 定义 为 带 有 Fact 或 Theory 特 性 注解 的 方法 。 在 方法 体 中 ， 使 用 Assert 类 定 














义 的 方法 对 测试 期 望 的 结果 与 实际 的 值 进行 比较 























央 
陷 或 限 


制 ? 





单元 测试 的 主要 缺陷 是 不 能 有 效 隔离 测试 中 的 组 件 。xUnitnet 特 有 的 最 大 问题 是 
缺失 文档 。 一 些 基 本 信息 请 参见 GitHub 网 站 ， 但 是 高 级 用 法 需要 做 一 些 试验 





























有 许多 测试 框架 可 用 ， 两 个 流行 的 选择 是 MSTest (来 自 微软 ) 和 NUnit 
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且 每 个 人 的 意见 并 不 相同 。 类 似 地 有 些 开 发 者 不 喜 
欢 将 单元 测试 的 代码 从 应 用 程序 代码 中 分 离 出 来 ， 
倾 问 于 将 训 试 定义 在 同一 个 项 目 中 ， 其 至 定义 在 同 
一 个 类 文件 中 。 这 里 介绍 的 是 第 用 方式 ， 也 是 本 书 
导 循 的 方式 ， 但 是 ， 如 果 不 适合 你 ， 那 么 你 应 该 竹 
试 其 他 的 测试 风格 ， 直 至 找到 上 自己 喜欢 的 。 





7.2.1 创建 单元 测试 项 目 


对 于 ASP.NET Core 应 用 程序 ， 通 稍 创 建 单 独 的 
Visual Studio 项 目 来 保存 单元 测试 ， 每 个 测试 定义 
为 C# 类 中 的 一 个 方法 。 使 用 单独 项 目 意味 着 可 以 部 


普 应 用 程序 而 不 需要 部 普 测 试 。 


为 了 创建 测试 项 目 ， 在 Solution Explorer 窗 格 
中 ， 右 击 WorkingWithVisualStudio 解 决 方案 ， 从 弹 
出 的 某 单 中 选择 Add~New Project。 在 弹出 的 Add 
New Project 对 话 框 中 ， 在 左 侧 选 择 Visual C# > .NET 
Core， 在 中 间 选 择 xUnit Test Project (.NET Core) 模 
板 ， 如 图 7-2 所 示 。 


Sa 


E 
ami) 


she 
Fo 


确保 选择 了 正确 的 项 目 模板 。Visual Studio fe 
供 了 多 种 单元 测试 的 项 目 模板 ， 并 且 它 们 有 类 似 的 
名 称 。 





图 7-2 ”选择 xUnit Test Project (.NET Core) ti Hx 


约定 的 命名 方式 是 将 单元 测试 项 目 命名 为 
<ApplicationName>.Tests。 将 新 项 目的 名 称 设置 为 
Working WithVisualStudio.Tests， 然 后 单 击 OK 按钮 
以 创建 新 项 目 。Visual Studio 将 会 创建 项 目 并 安装 
xUnit 对 应 的 NuGet 包 以 及 依赖 的 包 。 


删除 默认 测试 类 


Visual Studio 深 加 了 一 个 C# 类 到 该 测试 项 目 
中 ， 它 会 导致 后 面 示例 的 测试 结果 变 得 难以 理解 。 


右 击 WorkingWithVisualStudio.Tests 项 目 中 的 
UnitTestl.cs 文 件 ， 然 后 从 弹出 六 蛙 中 选择 Delete。 
在 提示 对 话 框 中 单 击 OK 按 钮 ，Visual Studio 将 会 删 
除 该 类 文件 。 


7.2.2 ”创建 项 目 引 用 


为 了 使 主 项 目 中 的 类 对 于 测试 项 目 可 用 ， 夺 击 
Solution Explorer 窗 格 中 的 
WorkingWithVisualStudio.Tests 项 ， 然 后 从 弹出 沫 单 
中 选择 Add “Reference。 选 中 Solution 部 分 的 
WorkingWithVisualStudio 项 ， 如 图 7-3 所 示 。 


Rrosn 


图 7-3 ”选择 WorkingWithVisualStudio 项 








单 击 OK 按 钮 以 创建 对 应 用 程序 项 目的 引用 。 
你 可 能 在 Solution Explorer 窗 格 的 测试 项 目的 
Dependencies 中 看 到 一 个 处 理 中 的 图 标 ， 但 是 一 旦 
你 构建 该 项 目 这 个 图 标 将 会 消失 。 


编写 和 运行 单元 测试 


现在 所 有 的 准备 工作 已 经 完成 ， 可 以 编写 一 些 
测试 。 为 了 开始 ， 如 代码 清单 7-5 所 示 ， 在 
WorkingWith- VisualStudio.Tests 项 目 中 添加 名 为 
ProductTests.cs 的 类 文件 ， 这 是 一 个 简单 的 类 文 
件 ， 但 是 其 中 包含 了 从 单元 测试 开始 所 和 需 的 一 切 。 


代码 清单 7-5 WorkingWithVisualStudio.Tests 文 件 夹 下 的 
ProductTests.cs 文 件 的 内 容 





using WorkingWithVisualStudio.Models; 
using Xunit; 


namespace WorkingWithVisualStudio.Tests { 


public class ProductTests { 


[Fact] 
public void CanChangeProductName() { 


// Arrange 
var p = new Product { Name = "Test", Price 


// Act 
p.Name = "New Name"; 


//Assert 
Assert.Equal("New Name", p.Name) ; 


} 


[Fact] 
public void CanChangeProductPrice() { 


// Arrange 

var p = new Product { Name = “Test", Price 
= 100M }; 

// Act 


p.Price = 200M; 


//Assert 
Assert.Equal(10@M, p.Price); 





a 
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CanChangeProductPrice 方 法 包含 故意 设置 的 错 


误 ， 这 将 在 本 节 稍 后 部 分 解决 。 





ProductTests 类 中 有 两 个 单元 测试 ， 其 中 的 每 个 
来 目 WorkingWithVisualStudio 项 目 中 Product 模 型 类 
的 不 同行 为 。 测 试 项 目 包含 许多 类 ， 其 中 的 每 个 可 
以 包含 多 个 单元 测试 。 


通常 ， 测 试 方法 的 名 称 描述 了 测试 的 内 容 ， 类 
的 名 称 摘 述 了 正在 测试 的 内 容 。 这 使 得 在 项 目 中 容 
易 组 织 测试 ， 在 通过 Visual Studio 运 行 测试 的 时 
修 ， 容 易 理 解 所 有 测试 的 结果 。 例 如 ， 名 称 
ProductTests 指 出 测试 的 是 Product 对 象 。 


应 用 于 每 个 方法 的 Fact 特 性 指出 这 是 一 个 测 
试 。 在 方法 体 中 ， 单 元 测试 齐 循 称 为 组 织 
(Arrange) 、 行 动 (Act) 、 上 断言 (Assert) 的 
A/A/A 模 式 。 组 织 是 指 为 测试 设置 条 件 ， 行 动 古 指 
执行 测试 ， 上 断言 是 指 验证 结 末 是 人 否 像 预期 的 那样 。 








测试 的 组 织 和 行动 部 分 都 是 第 规 的 C# 代 码 ， 但 
是 断言 部 分 由 xUnit.net 处 理 ，xUnit.net 提 供 了 一 个 
名 为 Assert 的 类 ， 其 方法 用 于 检 醋 行动 的 结果 是 盏 
如 预期 的 那样 。 


提 示 


Fact 特 性 和 Assert 类 都 定义 在 命名 空间 Xunit 
中 ， 因 此 所 有 的 测试 类 中 都 必须 有 using 语 句 。 








Assert 类 的 方法 是 静态 的 ， 用 于 比较 不 同 种 类 
的 期 望 值 和 实际 值 ， 表 7-3 展示 了 Assert 方法 的 常 
见 用 法 。 


表 7-3 xUnit.net 提 供 的 Assert 方 法 的 常见 用 法 























断言 结果 与 期 望 值 相等 。 该 方法 的 重 载 版 本 用 于 比较 不 同 的 
Equal(expected,result) 类 型 和 集合 。 该 方法 的 另 一 个 版 本 接收 一 个 额外 的 参数 对 
象 ， 该 对 象 实现 了 用 于 比较 对 象 的 IEqualityComparer<T> 接 


NotEqual(expected,result) 断言 结果 不 等 于 期 望 值 



























































断言 结果 为 指定 类 型 


IsNull(result) 断言 结果 为 null 





IsNotNull(result) 断言 结果 不 为 null 
InRange(result,low,high) 断言 结果 介 于 low 和 high 


新 言 结 果 
NotInRange(result,low,high) | 断言 结果 不 介 于 low 和 high 


Throws(exception,expression) | 断言 指定 的 表达 式 抛 出 指定 的 异常 类 型 








每 个 Assert 方 法 都 允许 进 行 不 同类 型 的 比较 ， 
GUAR SIUM AER, MIRAE o HA TER 
SINAR. FERS 7-5 Aras I EH 
Equal TARREI Jas VE AN (Ee a IEE: 


























Assert.Equal("New Name", p.Name) ; 


7.2.3 ”编写 并 运行 单元 测试 


Visual Studio 文 持 通 过 测试 管理 器 (Test 
Explorer) 否 找 和 运行 测试 。 可 以 通过 选择 


Test = Windows — Test Explorer 找 到 测试 管理 器 ， 如 
图 7-4 所 示 。 


I un_ = | Playlist : All Tests = 
4 Not Run Tests (2) Run All | Run. ~ | Playlist; All Tests ~ 
WarkingWithVisualStudio Tests ProductTestsCanChangeProductl] 4 Failed Tests (1) 


forkinghithVisualStudio.Tests.ProductTests.CanChangeProduct @3 WorkingWithVisualStudio.Tests.ProductTests.CanChangeProductPrice 11 ms 
1) 
hVisualStudio.Tests.ProductTests.CanChangeProductName 4 ms 








图 7-4 Visual Studio 的 测试 管理 器 


cr 


fe 示 

SR EWE Ellas PAA Boa, Mis 
重新 构建 解决 方案 ， 编 译 触发 单元 测试 的 发 现 过 
程 。 





可 通过 单 击 Test Explorer 窗 口中 的 Run Al 按钮 
来 运行 全 部 测试 。Visual Studio 将 使 用 xUnit.net 来 运 
行 项 目 中 的 测试 并 显示 结果 。 如 上 所 述 ， 
CanChangeProductPrice 测 试 包含 导致 测试 失败 的 钳 
误 。 问 题 源 目 AssertEqual 方 法 的 参数 ， 其 使 用 测试 
结果 来 比较 源 Price 属 性 值 而 不 是 修改 的 值 。 代 码 清 
单 7-6 纠 正 了 这 个 错误 。 











代码 清单 7-6 ”更 正 ProductTests.cs 文 件 中 的 测试 





using WorkingWithVisualStudio.Models; 
using Xunit; 


namespace WorkingWithVisualStudio.Tests { 


public class ProductTests { 


[Fact] 
public void CanChangeProductName() { 
// Arrange 
var p = new Product { Name = "Test", Price 


= 100M }; 


// Act 


p.Name = "New Name"; 

//Assert 

Assert.Equal("New Name", p.Name) ; 
} 
[Fact] 


public void CanChangeProductPrice() { 


// Arrange 

var p = new Product { Name = “Test", Price 
= 100M }; 

// Act 


p.Price = 200M; 


//Assert 
Assert.Equal(200M, p.Price); 





SMA AY, eh Fc te EU HEE, Fh 
for EWU ZA Ep al) EM ae AI ERRI PA AS ACE E 
件 。 


如 果 拥 有 大 量 测试 ， 那 么 全 部 运行 测试 十 要 秦 
费 一 些 时 间 。 为 了 快速 迭代 ， 训 斌 党 理 硕 提 供 了 不 
同 的 选项 来 测试 子 集 。 最 有 用 的 子 集 是 失败 的 测试 
集 ， 如 图 7-5 所 示 。 乍 新 运行 不 正确 的 测试 ， 测 试 
党 理 占 将 显示 没有 测试 失败 。 

















图 7-5 ”有 选择 地 运行 测试 


7.2.4 隔离 组 件 以 进行 单元 测试 


为 类 似 于 Product 这 样 的 类 编写 单元 测试 是 很 容 
易 的 。 不 是 因为 Product 关 简单 ， 而 是 因为 Product 关 
是 自 包含 的 ， 这 意味 着 当 在 Product 对 象 上 执行 操作 
时 ， 可 以 确认 是 在 测试 由 Product 类 提供 的 功能 。 


对 于 MVC 应 用 程序 中 的 其 他 组 件 来 襄 ， 情 况 
会 变 得 复杂 ， 因 为 它们 之 间 存 在 依赖 。 你 所 定义 的 
下 一 个 测试 集 将 处 理 控 制 器 ， 检 查 在 控制 器 和 视图 
之 间 传 递 的 Product 对 象 的 顺序 。 





当 比 较 通 过 目 定 义 的 类 实例 化 的 对 象 时 ， 需 要 
使 用 xUnit.net 中 的 Assert.Equal 方 法 来 接收 一 个 实现 
了 IEqualityComparer<T> 接 口 的 参数 ， 以 便 对 象 可 
以 比较 。 第 一 步 是 在 测试 项 目 中 添加 名 为 
Comparer.cs 的 文件 ， 用 它 定义 代码 清单 7-7 中 的 


Re 





代码 清单 7-7 WorkingWithVisualStudio.Tests 项 目 中 
Comparer.cs 文 件 的 内 容 


using System; 
using System.Collections.Generic; 


namespace WorkingWithVisualStudio.Tests { 
public class Comparer { 


public static Comparer<U> Get<U>(Func<U, U, boo 
l> func) { 
return new Comparer<U>(func) ; 


} 
} 


public class Comparer<T> : Comparer, IEqualityCompa 
rer<T> { 
private Func<T, T, bool> comparisonFunction; 


public Comparer(Func<T, T, bool> func) { 
comparisonFunction = func; 


} 


public bool Equals(T x, T y) { 
return comparisonFunction(x, y); 


} 


public int GetHashCode(T obj) { 
return obj.GetHashCode(); 





这 些 类 允许 使 用 Lambda 表 达 式 ， 而 不 是 针对 
每 种 组 件 类 型 定义 新 的 类 以 创建 
IEqualityComparer<T> 对 象 。 这 不 是 必需 的 ， 但 能 
简化 单元 测试 类 中 的 代码 ， 使 其 易 恋 、 另 于 维护 。 














现在 很 容易 进行 比较 ， 可 以 说 明 应 用 程序 组 件 
之 间 的 依赖 问题 。 添 加 名 为 HomeControllerTests.cs 
的 文件 到 WorkingWithVisualStudio.Tests 项 目 中 ， 定 
义 代码 清单 7-8 所 示 的 单元 测试 。 


代码 清单 7-8 WorkingWithVisualStudio.Tests 项 目 中 
HomeControllerTests.cs 文 件 的 内 容 





using Microsoft.AspNetCore.Mvc; 

using System.Collections.Generic; 

using WorkingWithVisualStudio.Controllers; 
using WorkingWithVisualStudio.Models; 
using Xunit; 


namespace WorkingWithVisualStudio.Tests { 
public class HomeControllerTests { 


[Fact ] 
public void IndexActionModelIsComplete() { 
// Arrange 


var controller = new HomeController(); 


// Act 
var model = (controller.Index() as ViewResu 
1t)?.ViewData.Model 
as IEnumerable<Product>; 


// Assert 
Assert.Equal(SimpleRepository.SharedReposit 
ory.Products, model, 
Comparer .Get<Product>((p1, p2) => p1.Na 
me == p2.Name 


&& p1.Price == p2.Price)); 








以 上 代码 清单 中 的 单元 测试 会 检查 Index 操 作 
方法 传递 给 视图 的 所 有 存储 库 中 的 对 象 〈 此 刻 忽略 
行动 部 分 ， 第 17 章 将 说 明 ViewResult 类 及 其 在 MVC 
应 用 程序 中 扮演 的 角色 ) 。 目 前 ， 知 道 Index 操 作 方 
法 返回 的 模型 数据 就 足够 了 。 








如 果 运 行 测试 ， 你 将 看 到 测试 失败 了， 指出 存 
储 库 中 的 对 象 集 不 同 于 Index 操 作 方法 返回 的 对 象 
集 。 为 了 弄 清楚 失败 的 原因 ， 有 个 问题 需要 解决 : 











假设 测试 是 在 Home 控 制 器 上 执行 ， 但 是 控制 器 类 
依赖 于 SimpleRepository 类 ， 这 使 得 难以 揭示 错误 来 
目测 试 目标 还 是 应 用 程序 的 男 一 部 分 。 


这 个 示例 应 用 程序 简单 到 可 以 通过 查看 
HomeController 和 SimpleRepository 类 的 代码 ， 束 能 
轻松 指出 问题 所 在 。 在 实际 应 用 程序 中 ， 目 视 检查 
并 不 容易 ， 依 赖 链 使 得 代码 难以 理解 导致 测试 失 
败 。 通 第 ， 存 储 库 将 依赖 于 茶 种 持久 化 存储 系统 

《比如 数据 库 ) 以 及 提供 访问 的 库 ， 单 元 测试 可 作 
用 于 整个 复杂 的 组 件 链 ， 其 中 任何 一 个 都 可 能 导致 


aR. 











当 目 标 只 针对 应 用 程序 的 一 小 部 分 时 ， 单 元 测 
试 是 有 效 的 ， 比 如 独立 的 方法 或 关 。 你 需要 做 的 是 
能 够 从 应 用 程序 的 其 他 部 分 隔离 Home 控 制 顷 ， 以 
便 可 以 限制 测试 的 范围 ， 并 排除 任何 存储 库 导 致 的 


mM 











隔离 组 件 


隔离 组 件 的 关键 是 使 用 C# 接 口 。 为 了 将 控制 大 
和 存储 库 分 离 ， 在 Models 文 件 夹 中 添加 名 为 
IRepository.cs 的 类 文件 ， 用 它 定 义 代码 清单 7-9 所 示 
的 接口 。 





代码 清单 7-9 Models 文 件 来 下 的 IRepository.cs 文 件 的 内 容 


using System.Collections.Generic; 
namespace WorkingWithVisualStudio.Models { 


public interface IRepository { 


IEnumerable<Product> Products { get; } 
void AddProduct(Product p); 
} 





} 





这 个 接口 没有 什么 特别 之 处 〈 除 没有 定义 第 见 
Web 应 用 程序 需要 的 全 部 操作 之 外 。 但 是 ， 添 加 这 
样 的 接口 可 以 使 你 能 够 轻松 隅 离 组 件 进 行 测试 。 第 
一 步 是 更 新 SimpleRepository 类 以 便 实 现 新 的 接口 ， 





如 代码 清单 7-10 所 示 。 


代码 清单 7-10 在 Model 文 件 夹 下 的 SimpleRepository.cs 文 件 中 
实现 接口 





using System.Collections.Generic; 


namespace WorkingWithVisualStudio.Models { 
public class SimpleRepository : IRepository { 
private static SimpleRepository sharedRepositor 
y = new SimpleRepository(); 
private Dictionary<string, Product> products 
= new Dictionary<string, Product>(); 


public static SimpleRepository SharedRepository 
=> sharedRepository; 


public SimpleRepository() { 
var initialItems = new[] { 


new Product { Name = "Kayak", Price = 2 
75M }, 
new Product { Name = "Lifejacket", Pric 
e = 48.95M }, 
new Product { Name = "Soccer ball", Pri 
ce = 19.50M }, 
new Product { Name = "Corner flag", Pri 
ce = 34.95M } 
}; 
foreach (var p in initialItems) { 
AddProduct(p); 
} 


products.Add( "Error", null); 


} 


public IEnumerable<Product> Products => product 
s.Values; 


public void AddProduct(Product p) => products.A 
dd(p.Name, p); 


} 








下 一 步 是 修改 控制 器 ， 以 便 引 用 存储 库 的 属性 
使 用 接口 而 不 是 类 ， 如 代码 清单 7-11 所 示 。 


代码 清单 7-11 在 Controller 文 件 夹 下 的 HomeController.cs 文 件 
中 添加 存储 库 属 性 








using Microsoft.AspNetCore.Mvc; 
using WorkingWithVisualStudio.Models; 
using System.Ling; 


namespace WorkingWithVisualStudio.Controllers { 
public class HomeController : Controller { 
public IRepository Repository = SimpleRepositor 
y.SharedRepository; 


public IActionResult Index() => View(Repository 
. Products 
.Where(P => p?.Price < 50)); 
[HttpGet] 
public IActionResult AddProduct() => View(); 


[HttpPost | 

public IActionResult AddProduct(Product p) { 
Repository .AddProduct(p) ; 
return RedirectToAction("Index") ; 





二 

fe ZN 

ASP.NET Core MVC 支 持 使 用 更 优雅 的 方式 来 
解决 这 个 问题 ， 这 称 为 依赖 注入 ， 将 在 第 18 章 说 


明 。 依 赖 注入 经 前 导致 混乱 ， 因 此 本 和 章 将 以 更 简 
单 、 更 手动 的 方式 来 隔离 组 件 。 








这 可 能 不 是 一 个 重大 变化 ， 但 是 它 允 许 在 测试 
期 间 改 变 控 制 占 使 用 的 存储 库 。 代 码 清单 7-12 更 新 


了 控制 器 的 单元 测试 ， 以 便 它们 使 用 特殊 版 本 的 存 
储 库 。 


代码 清单 7-12 ”在 HomeControllerTests.cs 文 件 的 单元 测试 中 陋 
离 控制 器 





using Microsoft.AspNetCore.Mvc; 

using System.Collections.Generic; 

using WorkingWithVisualStudio.Controllers; 
using WorkingWithVisualStudio.Models; 
using Xunit; 


namespace WorkingWithVisualStudio.Tests { 
public class HomeControllerTests { 


class ModelCompleteFakeRepository : IRepository 


public IEnumerable<Product> Products { get; 
} = new Product[] { 


new Product { Name = "P1", Price = 275M 
}; 

new Product { Name = "P2", Price = 48.9 
5M }, 

new Product { Name = "P3", Price = 19.5 
eM }, 

new Product { Name = "P3", Price = 34.9 
5M }}; 


public void AddProduct(Product p) { 
// do nothing - not required for test 


} 


} 


[Fact] 
public void IndexActionModelIsComplete() { 
// Arrange 
var controller = new HomeController(); 
controller.Repository = new ModelCompleteFa 
keRepository(); 


// Act 


var model = (controller.Index() as ViewResu 
1t)?.ViewData.Model 


as IEnumerable<Product>; 


// Assert 
Assert. Equal(controller.Repository. Products 
» model, 
Comparer .Get<Product>((p1, p2) => p1.Na 
= p2.Name 


&& p1.Price == p2.Price)); 





这 里 定义 了 一 个 假 的 IRepository 接 口 实现 ， 它 
仅仅 实现 了 测试 需要 的 属性 ， 并 使 用 始终 一 致 的 测 
试 数据 (使 用 真实 数据 库 可 能 不 是 这 种 情况 ， 特 列 
是 在 你 与 其 他 开 友 人 员 共 至 ， 并 且 他 们 正在 进行 日 
己 的 修改 时 ) 。 








修订 之 后 的 单元 测试 还 是 失败 了 ， 表 明 问 题 来 
自 HomeController 类 的 Index 操 作 方 法 ， 而 不 是 依赖 
的 组 件 。 通 过 单元 测试 进行 的 操作 方法 是 非常 简单 
的 ， 检 和 碍 问题 也 是 显而易见 的 。 





public IActionResult Index() => View(Repository.Product 





s.Where(p => p.Price < 50)); 


问题 来 目 LINQ 表 达 式 的 Where 方法 ，Where 方 
法 用 于 过 小 Price 属 性 大 于 或 等 于 50 的 Product 对 象 。 
在 这 一 点 上 ， 可 以 确信 产生 问题 的 原因 。 但 是 在 做 
修改 之 前 ， 最 佳 实践 是 创建 测试 来 确认 问题 ， 如 代 
码 清单 7-13 所 示 。 





代码 清单 7-13 ”在 WorkingWithVisualStudio.Tests 项 目的 
HomeControllerTests.cs 文 件 中 添加 测试 





using Microsoft.AspNetCore.Mvc; 

using System.Collections.Generic; 

using WorkingWithVisualStudio.Controllers; 
using WorkingWithVisualStudio.Models; 


using Xunit; 
namespace WorkingWithVisualStudio.Tests { 
public class HomeControllerTests { 


class ModelCompleteFakeRepository : IRepository 
public IEnumerable<Product> Products { get; 


} = new Product[] { 
new Product { Name = "P1", Price = 275M 


J 
new Product { Name = "P2", Price = 48.9 
5M }, 
new Product { Name = "P3", Price = 19.5 
QM }, 
new Product { Name = "P3", Price = 34.9 
5M }}; 


public void AddProduct(Product p) { 
// do nothing - not required for test 


} 
} 


[Fact] 
public void IndexActionModelIsComplete() { 
// Arrange 
var controller = new HomeController(); 
controller.Repository = new ModelCompleteFa 
keRepository(); 


// Act 
var model = (controller.Index() as ViewResu 
1t)?.ViewData.Model 
as IEnumerable<Product>; 


// Assert 


Assert.Equal(controller.Repository.Products 
, model, 
Comparer .Get<Product>((p1, p2) => p1.Na 
me == p2.Name 
&& p1.Price == p2.Price)); 
} 


class ModelCompleteFakeRepositoryPricesUnder5@ 
: [Repository { 


public IEnumerable<Product> Products { get; 
} = new Product[] { 


new Product { Name = "P1", Price = 5M }, 

new Product { Name = "P2", Price = 48.9 
5M }, 

new Product { Name = "P3", Price = 19.5 
eM }, 

new Product { Name = "P3", Price = 34.9 
5M }}; 


public void AddProduct(Product p) { 
// do nothing - not required for test 


} 
} 


[Fact] 
public void IndexActionModelIsCompletePricesUnd 
er50() { 
// Arrange 
var controller = new HomeController(); 
controller.Repository = new ModelCompleteFa 
keRepositoryPricesUnder5@(); 


// Act 


var model = (controller.Index() as ViewResu 
1t)?.ViewData.Model 
as IEnumerable<Product>; 


// Assert 
Assert. Equal(controller.Repository. Products 
» model, 
Comparer.Get<Product>((p1, p2) => p1.Na 
me == p2.Name 


&& p1.Price == p2.Price)); 





二 


提 ” 示 





这 些 测试 中 含有 大 量 的 重复 代码 。7.3 节 将 描述 
如 何 简 化 测试 。 


上 面 定 义 了 一 个 新 的 仅 含 有 Price 属 性 值 小 于 50 


的 Product 对 象 的 存储 库 ， 并 且 你 将 在 新 的 测试 中 仪 
使 用 这 个 存储 库 。 如 果 运 行 这 个 测试 ， 你 将 看 到 测 
试 成 功 了 ， 这 增加 了 问题 是 由 Index 操 作 方 法 中 
Where 方法 的 用 法 导致 的 权重 。 





在 真实 项 目 中 ， 了 解 测试 失败 的 原因 时 ， 需 要 
将 测试 的 目的 与 应 用 程序 的 规范 相 协调 。 可 能 的 情 
况 是 ，Index 探 作 方法 应 该 通过 Price 来 过 滤 Product 
对 象 ， 在 这 种 情况 下 ， 将 需要 修改 测试 。 这 是 常见 
的 结果 ， 失 败 的 测试 并 不 总 是 表明 应 用 程序 中 真正 
存在 问题 。 从 为 一 个 角度 说 ， 如 果 Index 操 作 方 法 不 
应 该 过 小 模型 对 象 ， 则 需要 更 正 修改 ， 如 代码 清单 
7-14 所 示 。 





代码 清单 7-14” 移 除 Controller 文 件 夹 下 的 HomeController.cs 文 
件 中 的 LINQ 过 滤器 





using Microsoft.AspNetCore.Mvc; 
using WorkingWithVisualStudio.Models; 
using System.Ling; 


namespace WorkingWithVisualStudio.Controllers { 
public class HomeController : Controller { 
public IRepository Repository = SimpleRepositor 
y.SharedRepository; 


public IActionResult Index() => View(Repository 
-Products) ; 


[HttpGet ] 
public IActionResult AddProduct() => View(new P 
roduct()); 


[HttpPost | 

public IActionResult AddProduct(Product p) { 
Repository .AddProduct(p) ; 
return RedirectToAction("Index") ; 
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程序 的 功能 ， 再 进行 测试 以 确保 按 需 工作 。 因 为 大 
多 数 开发 者 站 和 完 考 虑 应 用 程序 代码 ， 然 后 进行 测 





试 ， 所 以 这 种 风格 很 受 欢迎 。 





这 种 开发 方式 的 问题 在 于 倾向 于 只 关注 部 分 应 
用 程序 代码 ， 这 些 代码 要 么 难以 编写 ， 要 么 需要 重 
度 调试 ， 从 而 使 功能 的 某 些 方面 仅仅 得 到 部 分 测试 
或 未 经 测试 。 





男 一 种 开发 方式 是 测试 驱动 开发 TDD) 。 
TDD 中 有 很 多 变化 ， 但 核心 思想 是 在 实现 功能 本 刁 
之 前 为 功能 编写 测试 。 首 先 编写 测试 可 以 使 你 更 仔 
细 地 考虑 正在 实现 的 规范 ， 以 及 如 何 知 道 功能 已 经 
正确 实现 。TDD 不 是 深入 实现 细节 ， 而 是 提前 考虑 
成 功 或 失败 的 度量 。 





你 编写 的 测试 一 开始 都 将 失败 ， 因 为 你 的 新 功 
能 还 没有 实现 。 但 是 随 着 你 为 应 用 程序 添加 代码 ， 
你 的 测试 将 逐渐 从 红色 变 为 绿色 ， 并 且 在 所 有 功能 
都 完成 的 时 候 ， 测 试 将 全 部 通过 。TDD 需 要 训练 








它 确实 产生 了 更 全 面 的 测试 集 ， 并 且 生 成 更 可 徘 的 
代码 。 


如 果 重 新 运行 测试 ， 你 将 看 到 它们 全 部 通过 ， 
如 图 7-6 所 示 。 


© WorkingWithVisualStudio.Tests. HomeControllerTests.IndexActionModell... 41 ms 
© WorkingWithVisualStudio. Tests. HomeControllerTests.IndexActionModells... 2 ms 
© WorkingWithVisualStudio.Tests.ProductTests.CanChangeProductName 1 ms 


© WorkingWithVisualStudio. Tests.ProductTests.CanChangeProductPrice 12 ms 


Summary 


Last Test Run Passed (Total Run Time 0;00;01.5590048) 
© 4 Tests Passed 





图 7-6 ”所 有 测试 已 通过 


对 于 这 样 一 个 简单 的 问题 ， 看 起 来 需要 做 很 多 
工作 ， 但 是 在 实际 的 应 用 程序 中 ， 测 试 特定 组 件 的 
能 力 是 至 关 重 要 的 。 知 已 经 识别 出 问题 ， 只 有 在 有 
效 隅 离 组 件 的 情况 下 ， 才 能 验证 和 修复 程序 。 


7.3 ”改进 单元 测试 





7.2 节 介绍 了 在 Visual Studio 中 编写 和 运行 单元 
测试 的 基本 方法 ， 并 强调 了 隔离 正在 测试 的 组 件 的 
重要 性 。 本 节 将 介绍 一 些 更 加 高 级 的 工具 和 特性 ， 
你 可 以 使 用 它们 更 简洁 、 更 有 表现 力 地 编写 测试 。 
如 果 已 浸入 单元 测试 文化 ， 那 么 你 最 终 可 以 得 到 很 
多 测试 代码 ， 并 且 代 码 的 清晰 性 也 变 得 重要 起 来 ， 
特别 是 当 需 要 修改 测试 以 反映 开发 过 程 中 应 用 程序 
的 变化 并 进入 维护 阶段 时 。 











7.3.1 参数 化 单元 测试 


为 HomeController 类 编写 的 测试 显现 出 仪 针 对 
某 些 数据 值 的 问题 。 为 了 测试 这 种 情况 ， 最 终 创建 
了 两 个 类 似 的 测试 ， 每 个 都 有 目 己 的 假 的 存储 。 这 
是 一 种 重复 的 方式 ， 特 别 是 因为 这 些 测试 之 间 唯 一 
的 区 别 是 存储 中 Product 对 象 的 Price 属 性 的 decimal 








值 。 





xUnit.net 提 供 对 参数 化 测试 的 支持 。 其 中 的 测 
试 数 据 已 从 测试 中 删除 ， 以 便 单 个 方法 可 以 用 于 多 
个 测试 。 在 代码 清单 7-15 中 ， 使 用 参数 化 测试 功能 
来 删除 用 于 HomeController 类 的 测试 中 的 重复 数 
据 。 








代码 清单 7-15” 在 HomeControllerTests.cs 文 件 中 参数 化 单元 测 
试 





using Microsoft.AspNetCore.Mvc; 

using System.Collections.Generic; 

using WorkingWithVisualStudio.Controllers; 
using WorkingWithVisualStudio.Models; 
using Xunit; 


namespace WorkingWithVisualStudio.Tests { 
public class HomeControllerTests { 


class ModelCompleteFakeRepository : IRepository 
public IEnumerable<Product> Products { get; 
set; } 


public void AddProduct(Product p) { 


// do nothing - not required for test 


} 


[Theory] 
[InlineData(275, 48.95, 19.50, 24.95)] 
[InlineData(5, 48.95, 19.50, 24.95)] 
public void IndexActionModelIsComplete(decimal 
price1, decimal price2, 
decimal price3, decimal price4) { 
// Arrange 
var controller = new HomeController(); 
controller.Repository = new ModelCompleteFa 
keRepository { 
Products = new Product[] { 


new Product {Name = "P1", Price = p 
ricel }, 
new Product {Name = "P2", Price = p 
rice2 }, 
new Product {Name = "P3", Price = p 
rice3 }, 
new Product {Name = "P4", Price = p 
rice4 }, 
} 
}; 
// Act 


var model = (controller.Index() as ViewResu 
1t)?.ViewData.Model 
as IEnumerable<Product>; 


// Assert 
Assert.Equal(controller.Repository.Products 
, model, 
Comparer .Get<Product>((p1, p2) => p1.Na 
me == p2.Name 


&& p1.Price == p2.Price)); 





参数 化 单元 测试 使 用 Theory 特 性 而 不 是 标准 的 
Fact 特 性 ， 还 使 用 了 InLineData 特 性 ， 以 允许 为 单元 
测试 方法 定义 参数 的 指定 值 。 由 于 C# 限 制 了 特性 中 
数据 值 的 表达 方式 ， 因 此 在 测试 方法 上 定义 了 4 个 
decimal 参 数 用 于 为 InlineData 特 性 提供 值 。 可 在 测 
试 方法 中 使 用 decimal 值 来 生成 Product 对 象 的 数组 ， 
用 于 设置 假 的 存储 库 对 象 的 Products 属 性 。 








每 个 mline 特 性 定义 了 一 个 单独 的 单元 测试 ， 
在 Visual Studio 测 试管 理 器 中 显示 为 单独 的 项 ， 如 
图 7-7 所 示 。 测 试管 理 器 中 的 条 目 显 示 了 将 用 于 单 
元 测试 方法 中 参数 的 值 。 











Summary 





图 7-7” Visual Studio 测 试管 理 器 中 的 参数 化 测试 





从 方法 或 属性 中 获取 测试 数据 


在 特性 中 表达 数据 时 会 受到 限制 ， 这 限制 了 
InlineData 特 性 的 有 效 性 ， 但 另 一 种 答 代 方法 是 创建 
静态 方法 或 属性 来 返回 测试 需要 的 对 象 。 在 这 种 情 
况 下 ， 对 数据 的 定义 方式 没有 限制 ， 可 以 创建 更 广 
泛 的 测试 值 。 为 演示 如 何 工 作 ， 在 单元 测试 项 目 中 
添加 名 为 ProductTestData.cs 的 文件 ， 用 它 定义 代码 
清单 7-16 所 示 的 类 。 














代码 清单 7-16 WorkingWithVisualStudio.Tests 项 目 中 
ProductTestData.cs 文 件 的 内 容 





using System.Collections; 
using System.Collections.Generic; 
using WorkingWithVisualStudio.Models; 


namespace WorkingWithVisualStudio.Tests { 


public class ProductTestData : IEnumerable<object[ | 
> { 


public IEnumerator<object[]> GetEnumerator() { 
yield return new object[] { GetPricesUnder5 


Q() }; 
yield return new object[] { GetPricesOver5e 
}; 
} 
IEnumerator IEnumerable.GetEnumerator() { 
return this.GetEnumerator(); 
} 
private IEnumerable<Product> GetPricesUnder50() 
{ 


decimal[] prices = new decimal[] { 275, 49. 
95M, 19.50M, 24.95M }; 
for (int i = ð; i < prices.Length; i++) { 
yield return new Product { Name = $"P{i 
+ 1}", Price = prices[i] }; 
} 
} 


private Product[] GetPricesOver56 => new Produc 


tC] { 


new Product { Name = "P1", Price = 5 }, 
new Product { Name = "P2", Price = 48.95M } 


new Product { Name = "P3", Price = 19.50M } 


new Product { Name = "P4", Price 


24.95M } 





测试 数据 由 实现 了 IEnumerable<object[]> 接 口 


的 类 提供 ， 并 返回 一 个 对 象 数 组 序列 。 序 列 中 的 每 
个 对 象 数组 包含 一 个 将 要 传递 给 测试 方法 的 参数 
集 。 改 进 测 试 方法 以 便 接 收 Product 对 象 数 组 ， 
Product 对 象 数 组 为 测试 数据 添加 了 另外 一 层 。 该 层 
是 对 象 数 组 的 枚 举 ， 其 中 的 每 个 枚 举 元 又 都 包含 一 
个 Product 对 象 数组 。 测 试 数据 的 这 种 深度 结构 可 能 
令 人 困惑 ， 但 保证 正确 是 最 重要 的 ， 因 为 在 
Xunit.net 试 图 传递 给 测试 方法 的 参数 个 数 不 匹 配方 
法 签名 时 ， 测 试 将 不 会 工作 。 











构建 测试 数据 类 ， 以 便 使 用 私有 方法 或 属性 定 
义 单独 的 测试 数据 集 ， 然 后 通过 GetEnumerator 方 法 
组 合 到 对 象 数组 序列 中 。 为 了 演示 不 同 的 技术 ， 这 
里 使 用 方法 和 属性 创建 了 Product 对 象 数 组 ， 但 是 还 
有 男 一 种 方法 (选择 由 正在 测试 的 数据 类 型 来 驱 
动 ) 。 代 码 清单 7-17 展 示 了 如 何 通 过 Theory 特 性 的 
测试 数据 类 来 设置 测试 。 


代码 清单 7-17 ”在 HomeControllerTests.cs 文 件 中 使 用 测试 数据 





using Microsoft.AspNetCore.Mvc; 

using System.Collections.Generic; 

using WorkingWithVisualStudio.Controllers; 
using WorkingWithVisualStudio.Models; 
using Xunit; 


namespace WorkingWithVisualStudio.Tests { 
public class HomeControllerTests { 


class ModelCompleteFakeRepository : IRepository 


public IEnumerable<Product> Products { get; 
set; } 


public void AddProduct(Product p) { 
// do nothing - not required for test 
} 


[Theory ] 
[ClassData(typeof(ProductTestData) ) ] 
public void IndexActionModelIsComplete(Product[ 
] products ) { 
// Arrange 
var controller = new HomeController(); 
controller.Repository = new ModelCompleteFa 
keRepository { 
Products = products 


] 


// Act 
var model = (controller.Index() as ViewResu 
1t)?.ViewData.Model 
as IEnumerable<Product>; 


// Assert 
Assert.Equal(controller.Repository. Products 
» model, 
Comparer.Get<Product>((p1, p2) => p1.Na 
me == p2.Name 


&& p1.Price == p2.Price)); 





fe ” 示 





如 果 硕 望 在 与 单元 测试 相同 的 类 中 包含 测试 数 
据 ， 那 么 可 以 使 用 MemberData 特 性 代替 
ClassData。MemberData 特 性 使 用 字符 串 来 配置 将 
提供 IEnumerable<object[]> 的 胡 态 方法 名 称 ， 序 列 





中 的 每 个 数组 可 作为 测试 方法 的 参数 集 。 


将 特性 ClassData 配 置 为 测试 数据 类 的 类 型 ， 在 
本 例 中 是 ProductTestData。 在 运行 测试 的 时 候 ， 
Xunit.net 将 创建 ProductTestData 类 的 实例 ， 并 用 来 
为 测试 获取 测试 数据 序列 。 


注 意 


在 测试 管理 器 中 得 看 测试 代码 ， 你 将 看 到 
IndexActionModelIsComplete 测 试 有 单个 入 口 ， 尽 管 
ProductTestData 类 提供 了 两 个 测试 数据 集 。 这 发 生 
在 测试 数据 对 象 不 能 被 序列 化 的 情况 下 ， 可 以 通过 





在 测试 对 象 上 应 用 Serializable 特 性 来 解决 。 


7.3.2 ”改进 假 的 实现 


阳 离 组 件 的 有 效 性 需要 类 的 假 的 实现 以 提供 测 
斌 数据， 或 者 检查 组 件 应 有 的 行为 。 可 以 创建 实现 
了 IRepository 接 口 的 类 ， 这 是 一 种 有 效 的 方式 ， 但 
会 导致 为 期 望 运行 的 每 种 测试 创建 实现 类 型 。 作 为 
示例 ， 代 人 码 清单 7-18 展 示 了 为 检查 在 mdex 操 作 方 法 
中 是 否 只 调用 了 存储 库 中 Products 方 法 一 次 所 需要 
做 的 额外 工作 〈 当 担心 组 件 对 存储 库 进行 章 复 查询 
时 ， 这 种 测试 十 分 彰 抑 ， 会 导致 多 个 数据 库 奉 
询 ) 。 











代码 清单 7-18 ”为 HomeControllerTests.cs 文 件 添 加 单元 测试 





using Microsoft.AspNetCore.Mvc; 
using System.Collections.Generic; 
using WorkingWithVisualStudio.Controllers; 


using WorkingWithVisualStudio.Models; 
using Xunit; 
using System; 


namespace WorkingWithVisualStudio.Tests { 
public class HomeControllerTests { 


class ModelCompleteFakeRepository : IRepository 


public IEnumerable<Product> Products { get; 
set; } 


public void AddProduct(Product p) { 
// do nothing - not required for test 
} 
} 


[Theory] 
[ClassData(typeof(ProductTestData))] 
public void IndexActionModelIsComplete(Product[ 
] products ) { 
// Arrange 
var controller = new HomeController(); 
controller.Repository = new ModelCompleteFa 
keRepository { 
Products = products 
}; 
// Act 
var model = (controller.Index() as ViewResu 
1t)?.ViewData.Model 
as IEnumerable<Product>; 


// Assert 
Assert.Equal(controller.Repository. Products 
, model, 


Comparer.Get<Product>((p1, p2) => p1.Na 
me == p2.Name 
&& p1l.Price == p2.Price)); 


} 


class PropertyOnceFakeRepository : IRepository { 


public int PropertyCounter { get; set; } = 


ð; 
public IEnumerable<Product> Products { 
get { 
PropertyCounter++; 


return new[] { new Product { Name = 
"P1", Price = 100 } }; 
} 
} 


public void AddProduct(Product p) { 
// do nothing - not required for test 
} 
} 


[Fact] 
public void RepositoryPropertyCalledOnce() { 
// Arrange 
var repo = new PropertyOnceFakeRepository() ; 


var controller = new HomeController { Repos 
itory = repo }; 


// Act 
var result = controller.Index(); 


// Assert 
Assert.Equal(1, repo.PropertyCounter) ; 








假 的 实现 并 不 总 是 简单 的 数据 源 ， 它 们 也 可 以 
用 于 断言 组 件 执行 工作 的 方式 。 在 这 个 示例 中 ， 还 
加 了 一 个 简单 的 计数 器 属性 ， 它 在 每 次 读 取 存储 库 
的 Products 属 性 时 都 会 递增 ， 可 使 用 Assert.Equal 方 
法 来 确保 属性 仅 被 调用 一 次 。 
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创建 假 的 对 象 会 于 臻 失控， 最 好 的 方式 是 使 用 
假 的 框 染 ， 也 就 是 所 谓 的 mocking 框 架 〔 假 的 和 念 
冒 的 对 象 之 间 有 一 点 技术 区 别 ， 但 古 现在 ,测试 工 
其 为 易于 使 用 而 模糊 了 它们 之 间 的 区 别 ， 所 以 可 以 
区 荃 使 用 这 两 个 术语 ) 。 本 章 使 用 的 mocking 框 染 
名 为 Moq， 其 背景 如 表 7-4 所 未 。 


表 7-4 Moq 框 染 的 背景 


问题 


a 


IX 















































程序 中 创建 组 件 的 仿冒 实现 的 软件 包 



























































| 程序 的 部 件 变 得 容 




















Moq 使 用 Lambda 表 达 式 来 定义 仿冒 组 件 的 功能 ， 仪 仅 需 要 定义 测试 可 能 使 用 
的 功能 














有 何 缺 陷 或 
限制 ? 





习惯 语法 可 能 需要 一 点 努力 ， 请 从 GitHub 网 站 查看 文档 和 示例 















































有 多 种 替代 框架 可 用 ， 包 括 NSubstitue 和 FakeItEasy。 所 有 这 些 框架 都 提供 
似 的 功能 ， 可 在 它们 之 间 进 行 选择 
























































要 安装 Moq， 在 Solution Explorer ti t F A E 
WorkingWithVisualStudio.TestsJi H, MA% H Hy sé 5 
中 选择 Manage NuGet Packages。 单 击 Browse 按 钮 ， 
在 搜索 框 中 输入 moq。 从 包 列 表 中 选择 Moq， 如 图 
7-8 所 示 ， 单 击 Install 按 钮 ， 在 项 目 中 添加 包 。 
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把 Moq 添 加 到 单元 测试 项 目 中 ， 而 不 是 应 用 程 
序 项 目 中 。 


2. 创建 mock 对 象 


创建 mock 对 象 意 味 着 告诉 Moq 期 望 何 种 类 型 的 
对 象 ， 然 后 配置 其 行为 ， 将 mock 对 象 用 于 测试 的 目 
标 。 在 代码 清单 7-19 中 ， 使 用 Moq 来 蔡 换 用 于 测试 
HomeController 的 两 个 假 的 存储 库 。 


udio - NuGet: WorkingWithVisualStudio. Tests 


NuGet: WorkingWithVisualStudio.Tests = X 


Browse Installed += Updates NuGet Package Manager: WorkingWithVisual Studio. Tests 


moq x ~ © [7] include prerelease Package source: nuget.org 


Moq by Daniel Cazzulino, kzu, 14.2M downloads 
Moq is the most popular and friendly mocking framework for .NET 


Autofac.Extras.Moq by Autofac.Extras.Moq, 124K downloads V4.10-rc5-246 
The Moq integration package allows you to automatically create mock 
weave dependencies for both concrete and mock abstract instances in unit tests... 


Mogq.Contrib by kzu.net, 71.6K downloads 
Contributed features and third-party integration for Moq. Mog is the most popular and friendly mocking 
framework for .NET 
Grace.Moq by lan Johnson, 8.34K downloads Version: 4799 
Grace Moq is a companion library for Grace and Moq Author(s): Daniel Cazzulino, kzu 
license: https: 
taw.githubusercontent.com 





图 7-8 ”为 单元 测试 项 目 添加 包 


代码 清单 7-19 ”在 HomeControllerTests.cs 文 件 中 使 用 mock 对 象 





using Microsoft.AspNetCore.Mvc; 

using System.Collections.Generic; 

using WorkingWithVisualStudio.Controllers; 
using WorkingWithVisualStudio.Models; 
using Xunit; 

using System; 

using Moq; 


namespace WorkingWithVisualStudio.Tests { 
public class HomeControllerTests { 


[Theory ] 

[ClassData(typeof(ProductTestData) ) ] 

public void IndexActionModelIsComplete(Product[ 
] products ) { 


// Arrange 

var mock = new Mock<IRepository>() ; 

mock.SetupGet(m => m.Products).Returns(prod 
ucts); 


var controller = new HomeController { Repos 
itory = mock.Object }; 


// Act 
var model = (controller.Index() as ViewResu 
1t)?.ViewData.Model 
as IEnumerable<Product>; 


// Assert 
Assert.Equal(controller.Repository.Products 
, model, 
Comparer .Get<Product>((p1, p2) => p1.Na 
me == p2.Name 
&& p1.Price == p2.Price)); 
} 
[Fact] 


public void RepositoryPropertyCalledOnce() { 


// Arrange 

var mock = new Mock<IRepository>() ; 

mock.SetupGet(m => m.Products) 

-Returns(new[] { new Product { Name = 

P1", Price = 100 } }); 

var controller = new HomeController { Repos 
itory = mock.Object }; 

// Act 

var result = controller.Index(); 


// Assert 
mock.VerifyGet(m => m.Products, Times.Once) ; 





使 用 Moq 框 架 使 你 可 以 删除 IRepository 接 口 的 
假 的 实现 ， 并 使 用 很 少儿 行 代 人 码 蔡 换 它们 。 本 节 不 
会 详细 介绍 Moq 框 染 支 持 的 不 同 功能 ， 但 是 会 在 示 
例 中 介绍 Mog 框 染 的 使 用 方式 (有 关 Mog 框 架 的 示 
例 和 文档 ， 参 见 GitHub 网 站 ) 。 本 书 的 其 余 内 容 及 
示例 将 说 明 如 何 测 斌 不 同类 型 的 MVC 组 件 。 








第 一 步 是 创建 一 个 新 的 mock 对 象 ， 指 定 将 要 实 


var mock = new Mock<IRepository>(); 


创建 的 mock 对 象 仿 冒 了 IRepository 接 口 。 下 一 
步 是 定义 测试 所 需 的 功能 。 不 像 钊 规 实现 接口 的 
类 ，mock 对 象 仅仅 配置 测试 所 需 的 行为 。 对 于 第 一 
个 mock 存 储 库 ， 需 要 实现 Product 属 性 以 便 返 回 
Product 对 象 的 集合 并 通过 ClassData 特 性 传递 给 测试 








方法 ， 如 下 所 示 : 


mock.SetupGet(m => m.Products).Returns(products) ; 





SetupGet 方 法 用 于 实现 属性 的 读 取 器 。 该 方法 
的 参数 是 一 个 Lambda 表 达 式 ， 用 于 指定 待 实现 的 属 
性 ， 在 示例 中 是 Products。 在 SetupGet 方 法 的 返回 结 
果 上 调用 Returns 方 法 ， 以 指定 当 属 性 被 读 取 时 返回 
的 结果 。 对 第 二 个 mock 和 存储 库 使 用 同样 的 方法 ， 但 
古 指定 固定 值 ， 如 下 所 示 : 

















mock.SetupGet(m => m.Products) 
-Returns(new[] { new Product { Name = " 





P1", Price = 100 } }); 


Mock 类 定义 了 Object 属性 ， 用 于 返回 实现 了 指 
定 接口 且 带 有 所 定义 行为 的 对 象 。 在 这 两 个 单元 测 
试 中 ， 使 用 Object 属性 获取 存储 库 以 配置 控制 器 ， 














如 下 所 示 : 


var controller = new HomeController { Repository = mock 





.Object }; 





使 用 的 最 后 一 项 Moq 功 能 是 检查 Products 属 性 
是 否 只 被 调用 了 一 次 ， 如 下 所 示 : 


mock.VerifyGet(m => m.Products, Times.Once) ; 





VerifyGet 是 一 个 由 Mock 类 定义 的 方法 ， 用 于 
在 测试 完成 后 检查 mock 对 象 的 状态 。 在 本 例 中 ， 
VerifyGet 方 法 允许 检查 Products 属 性 被 读 取 的 次 
数 。 信 Times.Once 用 于 指定 如 果 属 性 不 止 谈 取 了 一 
1K, PIO Ra, ROSS MAA GHA, MA 
中 的 Assert 方 法 通过 在 测试 失败 时 抛 出 异常 来 工 
作 ， 这 束 是 VerifyGet 方 法 可 以 在 使 用 mock 对 象 时 办 
换 Assert 方 法 的 原因 ) 。 
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本 章 的 大 部 分 内 容 集中 于 单元 测试 ， 单 元 测试 
己 经 成 为 改进 代码 质量 的 强大 工具 。 单 元 测试 不 适 
合 每 个 开发 者 ， 但 值得 尝试 。 即 使 仅 用 于 复杂 功能 
或 问题 诊断 也 是 有 用 的 。 本 章 介绍 了 xUnit.net 框 架 
的 使 用 ， 说 明了 测试 隔离 组 件 的 重要 性 ， 演 示 了 简 
化 单元 测试 代码 的 一 些 工 具 和 技术 。 下 一 章 将 介绍 
如 何 开 友 更 现实 的 MVC 应 用 程序 ， 以 展示 不 同 功能 
的 组 件 如 何 协同 工作 。 











第 8 章 ”SportsStore 应 用 程序 


前 几 章 构建 了 快速 且 简 单 的 MVC 应 用 程序 ， 
描述 了 MVC 模 式 、 重 要 的 C# 功 能 以 及 优秀 的 MVC 
开发 人 员 所 需要 的 各 种 工具 。 现 在 是 时 候 组合 这 些 
技术 以 建立 简单 而 实用 的 电子 商务 应 用 程序 了 。 








创建 的 应 用 程序 名 为 SportsStore， 它 遵循 一 般 
在 线 商店 的 经 典 做 法 。 首 先 ， 创 建 在 线 产品 目录 
(客户 可 以 按 类 别 和 页 面 浏览 )、 购 物 车 《用 户 可 
以 添加 和 删除 产品 以 及 结账 单 〈 供 用 户 输 入 邮寄 详 
情 ) 。 然 后 ， 创 建 一 个 管理 区 域 ， 用 来 管理 目录 ， 
包括 创建 、 读 取 、 更 新 和 删除 CRUD) 功能 ， 这 
个 区 域 是 受 保护 的 ， 只 有 登录 的 管理 员 可 以 进行 更 
Ls 











本 章 的 目的 是 让 你 通过 创建 一 个 尽 可 能 真实 的 


例子 来 了 解 真 正 的 MVC 开 发 。 本 书 只 关注 
ASP.NET Core MVC， 所 以 简化 了 与 数据 库 等 外 部 
系统 的 集成 ， 并 完全 省 略 了 其 他 部 分 ， 如 支付 处 理 


A 入 
等 。 


你 可 能 会 肥 现 ， 建 立 所 需 的 基础 设施 部 分 的 过 
程 有 些 慢 ， 但 对 MVC 应 用 程序 的 基础 部 分 进行 投入 
是 很 有 好 处 的 ， 可 以 实现 可 维护 、 可 扩展 、 结 构 民 
好 的 代码 ， 并 对 单元 测试 提供 民 好 的 支持 。 





单元 测试 


本 书 已 经 强调 过 MVC 中 单元 测试 的 易 用 性 ， 
以 及 单元 测试 如 何 成 为 开 友 过 程 中 非常 重要 和 有 用 
的 部 分 。 在 本 书 的 这 一 部 分 ， 你 将 看 到 这 一 点 ， 
为 这 部 分 已 经 包含 与 关键 MVC 功 能 相关 的 单元 测试 
和 技术 细 市 。 








使 用 单元 测试 并 不 是 普遍 做 法 。 如 果 不 想 进 行 
单元 测试 ， 也 是 可 以 的 。 如 果 你 对 单元 测试 不 感 兴 
趣 ， 可 以 跳 过 这 部 分 ，SportsStore 应 用 程序 将 正常 
工作 。 你 不 需要 进行 任何 类 型 的 单元 测试 来 获得 
ASP.NET Core MVC 的 技术 优势 ， 当 然 ， 文 持 测试 
是 采用 ASP.NET Core MVC 的 关键 原因 。 





SportsStore 应 用 程序 中 使 用 的 大 多 数 MVC 功 能 
在 本 书后 面 也 会 单独 介绍 。 在 这 里 并 不 复制 所 有 的 
部 分 ， 这 里 讲 的 内 容 对 示例 应 用 程序 已 经 足够 了 ， 
但 会 给 出 对 应 的 其 他 章节 人 位置， 以便 你 获取 更 详细 
的 信息 。 








这 里 将 演示 构建 应 用 程序 所 需 的 每 个 步骤 ， 以 
便 你 可 以 看 到 MVC 功 能 如 何 组 合 在 一 起 。 当 创建 视 
图 时 ， 你 应 该 特别 注意 。 如 果 不 严 格 按照 示例 ， 也 


许 会 获得 一 些 奇 怪 的 结果 。 
8.1 准备 开始 


如 果 在 阅读 本 书 该 部 分 时 ， 你 在 自己 的 计算 机 
上 编写 SportsStore 应 用 程序 ， 则 需要 安装 Visual 
Studio， 并 确保 安装 LocalDB (这 是 持久 存储 数据 所 
必需 的 ) 。 如 果 巡 循 第 2 章 介 绍 的 操作 ，LocalDB 将 
目 动 安装 在 计算 机 上 。 
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如 果 只 想 在 不 重新 创建 项 目的 情况 下 执行 项 
目 ， 可 以 访问 Apress 网 站 ， 上 面 提 供 了 本 书 附带 的 
免费 源 代码 ， 可 以 从 本 书 的 GitHub 仓 库 中 下 载 








SportsStore 项 目的 源 代码 。 当 然 ， 你 不 需要 跟 兰 
fi. EE CIS JIE BEE E Al ASS H BE a 


解 。 


8.1.1 创建 MVC 项 目 


这 里 将 使 用 与 前 面 章 市 相同 的 基本 方法 ， 从 一 
个 空 项 目 开始 ， 并 添加 所 需 的 所 有 配置 文件 和 组 
件 。 从 Visual Studio 的 File 荣 单 中 选择 
New Project， 然 后 选择 ASP.NET Core Web 
Application 项 目 模 板 ， 如 图 8-1 所 示 。 将 项 目的 名 称 
设置 为 SportsStore， 然 后 早 击 OK 按钮 。 





D Recent 


二 [NET Framework 4.6.1 ~] Sort by: [Default 

















4 Installed cad 
Ls) Console App (.NET Core) Visual C= Type: Vig 
4 Visual C = Projectag 
Windows Classic Deskt pA i j # Core appi. 
e ows Classic Desktop 如 a Class Library (.NET Core) Visual C: MOS us 
~ Cs Framewo 
.NET Core 区 ] Unit Test Project (.NET Core) Visual C= ; 
NET Standard j e 
Cloud ra xUnit Test Project (.NET Core) Visual C= 
Test 、 
b Visual Basic í ASP.NET Core Web Application Visual C# q 
SOI Server vi e 
Not finding what you are looking for? £ 
Open Visual Studio Installer 
Name: SportsStore 7 
Location: |C:\Users\adam\Documents\ B = | Browse... 
Solution name: SportsStore [x] Create of 





Add tosg 
f 





图 8-1 选择 项 目 类 型 


选择 Empty 模板 ， 如 图 8-2 所 示 。 在 单 击 OK 按 
钮 创建 SportsStore 项 目 之 前 ， 确 保 在 对 话 框 项 部 的 
下 拉 列 表 中 选择 了 .NET Core 和 ASP.NET Core 2.0, 
并 且 未 勾 选 Enable Docker Support 复 选 框 。 


New ASP.NET Core Web Application - SportsStore 





NET Core ~ || ASP.NET Core 2.0 ~| Learn more 


An empty project template for creating an ASP.NET 
回 Bl Bl Q Core application. This template does not have any 
@ ® content in it. 


Web API Web Web Angular 


earn more 
Application Application - 
(Model-View- 
Controller) 





OO. 
Ep & 
React,js React,js and 
Redux 











Change Authentication 





Authentication No Authentication 


C Enable Docker Support 


OS: Windows 
Requires Docker for Windows 
Docker support can also be enabled later Learn more 








图 8-2 ”选择 项 目 模板 
1. 创建 文件 夹 结构 


下 一 步 是 洪 加 一 些 文件 来 ， 以 包 仿 MVC 应 用 
程序 所 二 的 应 用 程序 组 件 一 一 模型 、 控 制 右 和 视 
图 。 对 于 表 8-1 中 描述 的 每 个 文件 光 ， 右 击 Solution 
Explorer 窗 格 中 的 SportsStore 项 目 ， 从 弹出 的 亲 单 中 
选择 Add New Folder， 然 后 设置 文件 夹 的 名 称 。 

稍 后 还 需要 其 他 文件 来 ， 但 这 些 文件 夹 反 映 了 MVC 
应 用 程序 的 主要 部 分 ， 并 且 足 以 开始 使 用 。 





表 8-1 SportsStore 项 目 所 需 的 文件 夹 
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sso 


里 面包 含 与 视图 相关 的 所 有 内 容 ， 包 括 单个 Razor 文 件 、 视 图 开始 文件 和 视图 
导入 文件 


























Views 








2. 配置 应 用 





Startup 类 负责 配置 ASP.NET Core 应 用 程序 。 代 
码 清单 8-1 显 示 了 对 Startup 类 所 做 的 更 改 ， 以 局 用 
MVC 框 架 和 一 些 对 开发 有 用 的 相关 功能 。 


代码 清单 8-1 在 SportsStore 文 件 夹 下 的 Startup.cs 文 件 中 局 用 功 


Db, 
He 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading.Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace SportsStore { 
public class Startup { 
public void ConfigureServices(IServiceCollectio 


n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 


IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages() ; 
app.UseStaticFiles(); 
app.UseMvc(routes => { 


}); 





和 大 大 


Startup 关 是 一 项 重要 的 ASP.NET Core 功 能 ， 第 


14 半 会 详细 描述 它 。 


ConfigureServices 方 法 用 于 设置 共享 对 象 ， 可 
通过 依赖 注入 功能 在 整个 应 用 程序 中 使 用 ， 第 18 草 





将 详细 介绍 。 在 ConfigureServices 方 法 中 调用 的 
AddMvc 方 法 是 一 种 扩展 方法 ， 用 于 设置 MVC 应 用 
程序 使 用 的 共享 对 象 。 


Configure 方 法 用 于 设置 接收 和 处 理 HITP 请 
的 功能 。 在 Configure 方 法 中 调用 的 每 种 方法 都 是 扩 
展 方法 ， 用 于 设置 HTTP 请 求 处 理 器 ， 如 表 8-2 所 
A 


表 8-2 在 Start 类 中 调用 的 初始 化 方法 





























显示 发 生 在 应 用 程序 中 的 异常 的 详细 信息 ， 在 开发 过 程 中 很 
UseDeveloperExceptionPage() | 有 帮助 。 在 发 布 的 应 用 程序 中 不 应 该 启用 ， 在 第 12 章 中 发 布 
应 用 程序 时 会 禁用 该 特性 




































































在 HTTP 响 应 中 添加 一 条 简单 的 信息 ， 否 则 不 会 有 响应 体 部 
分 ， 例 如 ，404 - Not Fund 响 应 








UseStatusCodePages() 








UseStaticFiles() 启用 对 wwwroot 文 件 夹 中 静态 内 容 的 支持 


UseMvc() 启用 ASP.NET Core MVC 





接 下 来 ， 需 要 为 应 用 程序 准备 Razer 视 图 。 厂 
击 Views 文 件 严 ， 从 弹出 来 单 中 选择 Add- New 
Item， 从 ASP.NET 分 类 中 选择 MVC View Imports 
Page 项 目 ， 如 图 8-3 所 示 。 


单 击 Add 按 钮 以 创建 _ViewImports.cshtml 广 
件 ， 如 代码 清单 8-2 所 示 ， 设 置 狐 文件 的 内 容 。 


代码 清单 8-2 Views 文 件 夹 下 的 _ViewImports.cshtml 文 件 的 内 


PZ 


谷 


@using SportsStore.Models 
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 









Add New Item - SportsStore 
4 Installed Sort by: [Default GE Search (Ctrl+E) 
SP.NET C e a { 
Cod 向 MVC View Page ASP.NET Core Type: ASP.NET 
i P MVC View Imports 
as 向 MVC View Layout Page ASP.NET Core 7 
ASP.NET ce 4 
Gener | 向 MVC View Start Page ASP.NET Core 3 
Scripts a 
Content 4 
ce 
> Online RJ Razor Tag Helper ASP.NET Core F 
ce 
P) Middleware Class ASP.NET Core 4 
c: 
P) Startup class ASP.NET Core G 
2 Web Configuration File ASP.NET Core g 
Name: _Wiewlmports.cshtml f 








图 8-3 ”创建 视图 导入 文件 





语句 @using 允 许 在 视图 中 使 用 定义 在 命名 空间 
SportsStore.Models 中 的 类 型 ， 而 不 再 需要 引用 命名 
空间 。 而 语句 @addTagHelper 启 用 了 内 置 的 标签 助 
手 特性 ， 随 后 使 用 它 来 创建 反映 SportsStore 应 用 程 
序 的 配置 的 HTML 元 素 。 








8.1.2 ”创建 单元 测试 项 目 


创建 单元 测试 项 目的 过 程 与 第 7 草 摘 述 的 相 
同 。 右 击 Solution Explorer 窗 格 中 的 SportsStore 项 ， 
然后 从 弹出 的 荣 单 中 选择 Add~ New Project。 选 择 
xUnit Test Project (NET Core) 项 目 模板 ， 如 图 8-4 
所 示 ， 并 将 项 目 名 称 设 置 为 SportsStore.Tests。 单 击 
OK 按钮 即 可 创建 单元 测试 项 目 。 
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图 8-4 选择 项 目 模 板 


一 且 创 建 了 单元 测试 项 目 ， 融 右 击 解决 方案 资 
源 管 理 堪 中 的 SportsStore.Tests 项 目 并 从 弹出 沫 单 中 
选择 Edit SportsStore.Tests.csproj. YSN iS 8-3 
中 加 粗 显 示 的 新 元 素 ， 以 将 Moq 包 添加 到 测试 项 目 
中 ， 并 创建 对 SportsStore 项 目的 引用 。 确 保 为 Moq 
包 指 定 了 列表 中 显示 的 版 本 。 














代码 清单 8-3 ”在 SportsStore.Tests 项 目的 SportsStore.Tests.csproj 
文件 中 添加 包 


<Project Sdk="Microsoft.NET.Sdk"> 


<PropertyGroup> 
<TargetFramework>netcoreapp2.0</TargetFramework> 


<IsPackable>false</IsPackable> 
</PropertyGroup> 


<ItemGroup> 
<ProjectReference Include="..\SportsStore\SportsSto 
re.csproj" /> 
</ItemGroup> 


<ItemGroup> 
<PackageReference Include="Microsoft.NET.Test.Sdk" 
Version="15.3.@-preview-20170628-02" /> 
<PackageReference Include="xunit" Version="2.2.0" / 
> 
<PackageReference Include="xunit.runner.visualstudi 
o“ Version="2.2.0" /> 
<PackageReference Include="Moq" Version="4.7.99" /> 
</ItemGroup> 


</Project> 





在 将 更 改 保 存 到 .csproj 文 件 时 ，Visual Studio+} 
下 载 Moq 包 并 将 其 安装 到 单元 测试 项 目 中 ， 并 创建 
对 SportsStore 项 目的 引用 ， 以 便 其 中 包含 的 类 可 用 
于 测试 。 





8.1.3 ”测试 和 启动 应 用 程序 


现在 已 经 创建 并 配置 了 应 用 程序 和 单元 测试 项 
目 ， 可 以 进行 开发 了 。Solution Explorer 窗 格 应 包含 
图 8-5 所 示 的 项 目 。 如 果 看 到 不 同 的 项 目 或 项 目 不 
在 同一 位 置 ， 你 将 会 过 到 问题 ， 所 以 请 花 一 点 时 间 
检查 这 些 项 目 是 否 存 在 ， 并 已 位 于 正确 的 位 置 。 











Solution Explorer 
aa- o-s a|p 
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图 8-5 ”用 于 SportsStore 应 用 程序 和 单元 测试 项 目的 Solution 
Explorer 窗 格 


如 果 从 Debug 束 单 中 选择 Start Debugging (或 者 
选择 Start Without Debugging) ， 你 将 看 到 错误 页 








面 ， 如 图 8-6 所 示 。 显 示 错 误 消 息 是 因为 应 用 程序 
中 没有 控制 器 来 处 理 当前 的 请 求 ， 作 者 将 很 快 解决 


这 个 问题 。 





图 8-6 ”运行 SportsStore 应 用 程序 后 的 错误 页 面 


8.2 ”开始 领域 模型 开 友 





所 有 项 目 都 是 从 MVC 应 用 程序 的 核心 一 一 领 
域 模型 开始 的 。 这 是 一 个 电子 商务 应 用 程序 ， 因 此 
最 需要 的 模型 就 是 产品 。 添 加 名 为 Product.cs 的 类 文 
件 到 Models 文 件 夹 中 ， 并 用 它 定 义 代 码 清 和 早 8-4 所 
示 的 类 。 





代码 清单 8-4 Models 文 件 夹 下 的 Product,cs 文 件 的 内 容 


namespace SportsStore.Models { 


public class Product { 
public int ProductID { get; set; } 
public string Name { get; set; } 
public string Description { get; set; } 
public decimal Price { get; set; } 
public string Category { get; set; } 





8.2.1 创建 存储 库 


现在 需要 一 些 从 数据 库 获取 Product 对 象 的 方 
法 。 正 如 第 3 章 所 解释 的 ， 模 型 包括 用 于 从 持久 化 
数据 库 中 存储 和 检索 数据 的 逻辑 。 此 时 本 书 并 不 天 
心 如 何 实现 数据 持久 性 ， 但 本 书 将 为 之 定义 接口 。 
在 Models 文 件 夹 中 添加 名 为 IProductRepository.cs 的 
C# 接 口 文件 ， 并 用 它 定 义 代码 清单 8-5 所 示 的 接 
Ho 


代码 清单 8-5 ”Models 文 件 夹 下 的 IProductRepository.cs 文 件 的 
内 容 


using System.Lingqg,; 


namespace SportsStore.Models { 


public interface IProductRepository { 


IQueryable<Product> Products { get; } 





这 个 接口 使 用 IQueryable<T> 来 允许 调用 者 获得 
一 系列 Product 对 象 。IQueryable<T> 接 口 来 目 你 更 
熟悉 的 IEnumerable<T> 接 口 ， 表 示 可 以 查询 的 对 象 
集合 ， 例 如 由 数据 库 管 理 的 对 象 。 





依赖 于 IProductRepository 接 口 的 类 可 以 获取 
Product 对 象 ， 而 无 须知 道 它们 的 存储 方式 或 实现 类 
将 会 如 何 传递 它们 的 详细 信息 。 





IEnumerable <T> 和 IQueryable <T> 接 口 


IQueryable<T> 接 口 很 有 用 ， 因 为 它 允 许 有 效 地 


查询 对 象 集合 。 在 本 章 的 后 面 ， 将 添加 对 从 数据 库 
中 检索 产品 对 象 子 集 的 文 持 ， 并 且 IQueryable<T> 接 
口 允许 使 用 标准 LINQ 语 句 回 数据 库 查 询 需 要 的 对 
象 ， 而 无 须知 道 数据 库 服 务 费 存储 数据 或 处 理 查 询 
的 方式 。 如 果 没 有 IQueryable<T> 接 口 ， 本 书 将 不 得 
不 从 数据 库 中 检索 所 有 Product 对 象 ， 然 后 丢弃 那些 
不 想 要 的 对 象 ， 随 看 应 用 程序 使 用 的 数据 量 的 增 
加 ， 代 价 将 变 得 非 钊 晤 贯 。 正 因为 如 此 ， 数 据 库存 
储 库 接口 和 类 通常 使 用 IQueryable<T> 接 口 而 不 是 
IEnumerable<T> 接 口 。 但 是 ， 必 须 小 心 使 用 
ne mp Da a 时 ， 都 
会 再 次 评估 得 询 ， 这 意味 着 将 回 数 据 库 发 送 新 的 得 
询 。 这 可 能 会 破坏 fit FAtQueryable<t> 的 好 处 。 在 这 
种 情况 下 ， 可 以 使 用 ToList 或 ToArray 扩 展 方法 将 
IQueryable<T> 转 换 为 更 可 预测 的 形式 。 














8.2.2 ”创建 虚拟 存储 库 


既然 已 经 定义 了 一 个 接口 ， 就 可 以 实现 持久 化 
机 制 并 连接 到 一 个 数据 库 ， 但 是 这 里 希望 先 添 加 应 
用 程序 的 其 他 部 分 。 为 此 ， 创 建 IProductRepository 
接口 的 虚拟 实现 ， 等 到 再 次 处 理 数据 存储 的 时 候 再 
真正 实现 。 为 了 创建 虚拟 存储 库 ， 在 Models 文 件 夹 
中 添加 名 为 FakeProductRepository.cs 的 文件 ， 并 用 
它 定 义 代码 清单 8-6 所 示 的 类 。 





代码 清单 8-6 ”Models 文 件 夹 下 的 FakeProductRepository.cs 文 件 
的 内 容 





using System.Collections.Generic; 
using System.Ling; 


namespace SportsStore.Models { 


public class FakeProductRepository : IProductReposi 
tory { 


public IQueryable<Product> Products => new List 
<Product> { 
new Product { Name = "Football", Price = 25 


J 


new Product { Name = "Surf board", Price = 
179 }, 
new Product { Name = "Running shoes", Price 


= 95 } 
}.AsQueryable<Product>() ; 





FakeProductRepository 类 人 返回 固定 的 Product 对 
象 集合 ， 并 作为 Products 属 性 的 值 ， 以 此 实现 
IProductRepository 接 口 。 实 现 IProductRepository 接 
口 时 还 需要 AsQueryable 方 法 ， 用 于 将 固定 的 对 象 集 
合 转换 为 IJQueryable <Product>， 并 人 允许 创建 兼容 的 
虚拟 存储 库 而 不 必 处 理 真正 的 查询 。 





8.2.3 注册 存储 库 服务 


MVC 强调 使 用 松 耘 合 组 件 ， 这 意味 着 在 更 改 
应 用 程序 的 菏 个 部 分 后 ， 无 须 在 其 他 位 置 进行 相应 
的 更 改 。 这 会 将 应 用 程序 的 一 部 分 变 成 服务 ， 这 些 
服务 提供 了 应 用 程序 其 他 部 分 需要 使 用 的 功能 。 这 
些 类 提供 的 服务 可 以 更 改 或 着 换 ， 而 无 须 更 改 使 用 








它们 的 类 。 第 18 章 将 深入 解释 这 一 点 ， 但 对 于 
SportsStore 应 用 程序 ， 作 者 硕 望 创 建 存 储 库 服务 ， 

以 允许 控制 器 获取 实现 了 IProductRepository 接 口 的 
对 象 ， 而 不 需要 知道 正在 使 用 哪个 类 。 可 以 使 用 之 
前 创建 的 FakeProductRepository 类 开发 应 用 程序 ， 
然后 蔡 换 为 真正 的 存储 库 ， 而 无 须 对 需要 访问 存储 
库 的 所 有 类 进行 更 改 。 服 务 已 在 Startup 类 的 
ConfigureServices 方 法 中 注册 ， 在 代码 清单 8-7 中 ， 
为 存储 库 定 义 了 新 的 服务 。 





代码 清单 8-7 在 SportsStore 文 件 夹 下 的 Startup.cs 文 件 中 创建 存 
储 库 服务 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using SportsStore.Models; 


namespace SportsStore { 


public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddTransient<IProductRepository, F 
akeProductRepository>() ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 


}); 





添加 到 ConfigureServices 方 法 的 语句 告诉 
ASP.NET Core 当 组 件 〈“ 如 控制 器 ) 需要 
IProductRepository 接 口 的 实现 时 ， 应 该 会 收 到 一 个 
FakeProductRepository 对 象 。AddTransient 方 法 指定 
了 一 个 新 的 FakeProductRepository 对 象 ， 每 次 需要 
IProductRepository 接 口 时 都 应 创建 它 。 现 在 这 段 代 


码 还 没有 任何 意义 ， 不 要 担心 ， 你 很 快 就 会 看 到 如 
何 将 之 应 用 于 应 用 程序 ， 第 18 章 将 详细 介绍 这 些 情 
况 。 
8.3 ”显示 产品 清单 

可 以 在 本 章 的 其 余部 分 构建 领域 模型 和 存储 
库 ， 而 不 触及 应 用 程序 的 其 余部 分 。 不 过 ， 你 可 能 


会 觉得 无 聊 ， 所 以 想 要 切换 一 下 ， 开 始 认真 使 用 
MVC， 并 根据 需要 添加 模型 和 存储 库 。 











在 本 市 中 ， 将 创建 一 个 控制 融和 一 个 操作 方 
法 ， 可 以 在 存储 库 中 显示 产品 的 详细 信息 。 目 前 ， 
这 只 是 为 了 显示 虚拟 存储 库 中 的 数据 ， 但 和 后 会 对 
其 进行 排序 。 这 里 还 将 设置 初始 路 由 配置 ， 以 便 
MVC 知 道 如 何 将 应 用 程序 的 请 求 映 射 到 创建 的 控制 
AF o 











使 用 Visual Studio MVC 脚 手 架 


在 本 书 中 ， 都 是 通过 右 击 Solution Explorer 窗 格 
中 的 文件 夹 来 创建 MVC 控 制 器 和 视图 ， 方 法 是 从 弹 
出 菜单 中 选择 Add -New Item， 然 后 在 Add New 
Item 窗 口中 选择 模板 。 还 有 一 种 蔡 代 方案 ， 称 为 
scaffolding (脚手架 ) , Visual Studio 在 Add 菜 单 
提供 了 专门 用 于 创建 控制 器 和 视图 的 菜单 项 。 当 选 
择 这 些 亲 单项 时 ， 需 要 为 创建 的 组 件 选 择 场 景 ， 例 
如 有 其 有 读 / 写 操作 的 控制 器 或 包含 用 于 创建 特定 模型 
对 象 的 表单 视图 。 





本 书 不 使 用 脚手架 。 脚 手 架 生成 的 代码 和 标记 
是 非常 通 用 的 ， 但 并 不 是 很 有 用 ， 因 为 这 些 代 码 和 
标记 只 能 文 持 一 组 特定 的 场景 ， 不 能 解决 常见 的 开 
发 问题 。 本 书 的 目标 不 仅 在 于 确保 你 知道 如 何 创建 





MVC 应 用 程序 ， 还 需要 解释 幕后 的 一 切 工 作 。 如 琳 
将 创建 组 件 的 贡 任 交 给 脚 手 杂 ， 解 释 起 来 将 会 更 加 
困难 。 


也 就 是 说 ， 你 的 开 肥 风格 可 能 与 作者 的 不 同 ， 
并 且 你 可 能 更 喜欢 在 自己 的 项 目 中 使 用 脚手架 ， 
将 是 发 一 种 情况 。 这 是 非常 合理 的 ， i 
时 间 了 解 脚 手 架 的 作用 ， 以 便 在 没有 得 到 预期 结果 
的 情况 下 知道 去 哪里 检查 。 








8.3.1 添加 一 个 控制 器 


为 了 在 应 用 程序 中 创建 第 一 个 控制 占 ， 将 名 为 
ProductController.cs 的 类 文件 添加 到 Controllers 文 件 
夹 中 ， 并 定义 代码 清单 8-8 所 示 的 类 。 


代码 清单 8-8 ”Controller 文 件 夹 下 的 ProductController.cs 文 件 的 


using Microsoft.AspNetCore.Mvc; 
using SportsStore.Models; 


namespace SportsStore.Controllers { 


public class ProductController : Controller { 
private IProductRepository repository; 


public ProductController(IProductRepository rep 


repository = repo; 





当 MVC 需 要 创建 一 个 新 的 ProductController 实 
例 来 处 理 HTTP 请 求 时 ， 它 将 检查 构造 函数 ， 并 看 
到 需要 一 个 实现 了 IProductRepository 接 口 的 对 象 。 
要 确定 应 该 使 用 什么 实现 类 ，MVC 会 参考 Startup 类 
中 的 配置 ， 得 知 应 该 使 用 FakeRepository， 并 日 每 
次 都 应 该 创建 一 个 新 的 实例 。MVC 会 创建 一 个 新 的 
FakeRepository 对 象 ， 并 使 用 它 调用 
ProductController#4Jié phi 2, LAG!) 2 AY AFH HTTP 





请 求 的 控制 锻 对 象 。 


这 称 为 依赖 注入 〈dependency injection) ， 这 
种 方式 允许 ProductController 通 过 IProductRepository 
接口 访问 应 用 程序 的 存储 库 ， 而 无 顷 了 解 配置 了 哪 
个 实现 类 。 之 后 ， 将 使 用 真实 存储 库 蔡 换 虚 拟人 存储 
库 ， 使 用 依赖 注入 意味 着 控制 器 将 继续 工作 而 无 须 
做 任何 更 改 。 


W 


y = 
E a 





一 些 开 发 者 不 可 欢 依赖 注入 ， 并 认为 它 会 使 应 
用 程序 更 加 复杂 。 作 者 不 这 样 认为 ， 但 如 末 你 刚 开 
始 使 用 依赖 注入 ， 那 么 建议 你 看 完 第 18 章 后 ， 再 来 
RE ze BEA o 





接 下 来 ， 添 加 一 个 名 为 List 的 操作 方法 ， 它 将 
呈现 一 个 视图 ， 以 显示 存储 库 中 产品 的 完整 列表 ， 
如 代码 清单 8-9 所 示 。 


代码 清单 8-9 ”在 Controller 文 件 夹 下 的 ProductController.cs 文 件 
中 添加 一 个 操作 方法 

using Microsoft.AspNetCore.Mvc; 

using SportsStore.Models; 

namespace SportsStore.Controllers { 


public class ProductController : Controller { 
private IProductRepository repository; 


public ProductController(IProductRepository rep 


o) { 


repository = repo; 


} 


public ViewResult List() => View(repository.Pro 
ducts); 
} 
} 








像 这 样 调用 View 方 法 (不 指定 视图 名 称 〉 会 告 
诉 MVC 演 染 操作 方法 的 默认 视图 。 将 
List<Product> (Product 对 象 列 表 ) 传递 给 View 方 
法 ， 从 而 为 框架 提供 在 强 类 型 视图 中 填充 Model 对 
象 的 数据 。 


8.3.2 ”添加 并 配置 视图 


需要 创建 视图 以 呈现 用 户 的 内 容 ， 还 需要 执行 
一 些 准 备 步 又 来 让 视图 更 人 简单。 前 先 ， 创 建 共 至 布 
局 ， 定 义 将 被 包含 在 及 送 给 客户 端的 所 有 HTML 咯 
应 中 的 通用 内 容 。 共 孚 布局 是 确保 视图 一 致 并 包含 
重要 的 JavaScript 文 件 和 CSS 样 式 表 的 有 效 方法 ， 第 
5 草 解释 了 它们 的 工作 原理 。 




















创建 Views/Shared 文 件 严 ， 并 添加 名 为 
_Layout.cshtml 的 MVC 视 图 布局 页 面 ， 
_Layout.cshtml 是 Visual Studio 分 配给 这 类 项 目的 默 


认 名 称 。 代 人 码 清 单 8-10 显 示 了 _Layout.cshtml 文 件 的 
内 容 ， 其 中 对 默认 内 容 进行 了 更 改 ， 将 title 元 素 的 
内 容 设 置 为 SportsStore。 


代码 清单 8-10 ”Views/Shared 文 件 严 下 的 _Layout.cshtml 文 件 的 


内 容 


<!DOCTYPE html> 


<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/ > 

<title>SportsStore</title> 
</head> 
<body> 

<div> 

@RenderBody () 

</div> 
</body> 
</html> 











接 下 来 ， 需 要 配置 应 用 程序 ， 以 便 默 认 应 用 
_Layout.cshtml 文 件 ， 这 可 通过 将 名 为 
_ViewStart.cshtml 反 MVC 视 图 局 动 文件 添加 到 


Views 文 件 夹 来 完成 。Visual Studio 添 加 的 默认 内 容 
如 代码 清单 8-11 所 示 ， 选 择 名 为 _Layout.cshtml 的 布 
局 ， 访 布局 对 应 代码 清单 8-11 所 示 的 文件 。 





代码 清单 8-11 Views 文 件 夹 下 的 _ViewStart.cshtml 文 件 的 内 容 


@{ 
} 


Layout = "_Layout"; 





现在 需要 添加 一 个 视图 ， 当 名 为 List 的 操作 方 
法 用 于 处 理 请 求 时 将 显示 这 个 视图 。 创 建 
Views/Product C(F3€, FME AList.cshtml ýs 
Razor 视 图 文件 ， 然 后 添加 代码 清单 8-12 所 示 的 标 
oe 


代码 清单 8-12 ”Views/Product 文 件 夹 下 的 List.cshtml 文 件 的 内 


mL 
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@model IEnumerable<Product> 


@foreach (var p in Model) { 
<div> 


<h3>@p.Name</h3> 

@p .Description 

<h4>@p.Price.ToString("c")</h4> 
</div> 


} 








文件 顶部 的 @model 表 达 式 指定 视图 将 从 操作 
方法 中 接收 一 系列 Product 对 象 作 为 模型 数据 。 使 用 
@foreach 表 达 式 来 处 理 序 列 ， 并 为 接收 的 每 个 
Product 对 象 生 成 一 组 简单 的 HTML 元 素 。 


视图 不 知道 Product 对 象 来 自 哪 里 ， 如 何 获取 ， 
以 及 它们 是 否 代表 应 用 程序 已 知 的 所 有 产品 。 相 
反 ， 视 图 仅 涉及 使 用 HTML 元 素 显示 每 个 产品 的 详 
细 信 息 ， 这 与 第 3 章 描述 的 关注 点 分 离 是 一 致 的 。 
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可 使 用 .ToString ("c") 方法 将 Price 属 性 转换 为 
字符 串 ， 访 方法 会 根据 服务 右上 有 效 的 culture 设 置 
将 数值 作为 货币 进行 转换 。 例 如 ， 如 果 服 务 器 设置 
为 en-US， (1002.3) .ToString ("c") 将 返回 
$1,002.30; 但 如 果 服 务 器 设置 为 en-GB， 那 么 相同 
的 方法 将 返回 £1,002.30。 


8.3.3 ”设置 默认 路 由 


需要 告诉 MVC 它 应 该 将 访问 应 用 程序 的 根 
URL (****://mysite/) 的 请 求 发 送 到 
ProductController 类 的 名 为 List 的 操作 方法 。 可 通过 
编辑 Startup 类 中 的 语句 来 设置 处 理 HTTP 请 求 的 
MVC 类 ， 如 代码 清单 8-13 所 示 。 


代码 清单 8-13 ”更 改 $portStore 文 件 夹 下 的 Startup.cs 文 件 中 的 默 
认 路 由 


using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using SportsStore.Models; 


namespace SportsStore { 
public class Startup { 
public void ConfigureServices(IServiceCollectio 


n services) { 
services.AddTransient<IProductRepository, F 


akeProductRepository>(); 
services.AddMvc(); 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes .MapRoute( 
name: "default", 
template: "{controller=Product}/{ac 
tion=List}/{id?}"); 
}); 





Startup 类 的 Configure 方 法 用 于 设置 请 求 管 道 ， 
由 检查 HTTP 请 求 并 生成 响应 的 类 《〈 称 为 中 间 件 ) 
组 成 。UseMvc 方 法 用 于 设置 MVC 中 间 件 ， 其 中 一 
个 配置 选项 用 于 将 URL 映 射 到 控制 器 和 操作 方法 。 
第 15 章 和 第 16 章 将 详细 描述 路 由 系统 ， 但 代码 清单 
8-13 告 诉 MVC 将 请 求 发 送 到 Product 控 制 器 的 名 为 
List 的 操作 方法 ， 除 非 请 求 URL 另 有 指定 。 
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需要 将 代码 清单 8-13 中 的 控制 器 名 称 设置 为 
Product if 4 7 42 till 48 K HY 4 #KProductController, 
这 是 MVC 命 名 约定 的 一 部 分 ， 其 中 控制 句 类 的 名 称 
通常 以 Controller 结 尾 ， 但 是 在 引用 类 时 会 急 略 这 部 





8.3.4 运行 应 用 程序 





现在 所 有 基础 工作 已 准备 就 绪 。 创 建 了 一 个 控 
制 嚣 ， 其 中 包含 一 个 操作 方法 ， 当 请 求 应 用 程序 的 
默认 URL 时 ，MVC 将 使 用 这 个 操作 方法 。MVC 将 
创建 一 个 FakeRepository 实 例 ， 并 使 用 它 创 建 一 个 
新 的 控制 器 对 象 来 处 理 请 求 。 虚 拟 存储 库 将 为 控制 
器 提供 一 些 简 单 的 测试 数据 ， 将 操作 方法 传递 给 
Razor 视 图 ， 以 便 在 发 送 给 浏览 器 的 HIML 响 应 中 包 
含 每 个 产品 的 详细 信息 。 当 生成 HIML 啊 应 时 ， 
MVC 将 来 自 操 作 方 法 所 选 视图 的 数据 与 来 自 共享 布 
局 的 内 容 相 结合 ， 生 成 浏览 器 可 以 解析 和 显示 的 完 
整 HTML 文 档 。 可 以 通过 启动 应 用 程序 来 查看 结 
果 ， 如 图 8-7 所 示 。 




















图 8-7” 奉 看 基本 的 应 用 程序 功能 


这 是 ASP.NET Core MVC 的 典型 开发 模式 。 虽 
然 需要 花费 一 点 时 间 才 能 完成 所 有 的 初始 设置 ， 但 
这 是 必要 的 ， 这 样 应 用 程序 的 基本 功能 才能 快速 集 
成 在 一 起 。 


8.4 准备 数据 库 


可 以 显示 包含 产品 详细 信息 的 人 简单 视图 ， 但 使 
用 虚拟 存储 库 近 供 的 测试 数据 。 在 使 用 真实 数据 实 
现 真正 的 存储 库 之 前 ， 需 要 建立 数据 库 并 用 一 些 效 
据 填 元 。 





这 里 将 使 用 SQL Server 作 为 数据 库 ， 并 且 使 用 
Entity Framework Core (EF Core) (Microsoft.NET 
MRARUY CORM) 框架 ) 访问 数据 库 。ORM 
框架 通过 常规 C# 对 象 呈现 关系 数据 库 的 表 、 列 和 
iT 


可 以 从 各 种 工具 和 技术 中 进行 选择 。 不 仅 可 以 
使 用 不 同 的 关系 数据 库 ， 还 可 以 使 用 对 象 存 储 库 、 
文档 存储 和 其 他 一 些 更 复杂 的 备 选 方案 。 甚 至 可 以 
使 用 其 他 的 .NET ORM 框 架 ， 每 个 框架 都 采用 稍微 
不 同 的 实现 方式 ; 这 些 变 化 可 能 更 适合 你 的 项 目 。 


这 里 选择 Entity Framework Core 有 几 个 原因 : 
使 用 起 来 简单 ， 与 LINQ 的 集成 非常 好 ， 并 且 能 够 
与 ASP.NET Core MVC 很 好 地 协作 。 早 期 的 版 本 多 
少 有 点 问题 ， 但 是 现在 的 版 本 非常 优雅 ， 而 且 功 能 
丰富 











SQL Server 有 一 个 很 好 的 功能 LocalDB, 

它 是 专 为 开 及 人 员 设 计 的 ， 共 有 基本 的 SQL Server 
功能 ， 并 且 不 需要 管理 功能 。 有 了 LocalDB， 束 可 
以 在 构建 项 目 时 跳 过 设置 数据 库 的 步骤 ， 稍 后 再 部 
El 56S INSQL Server 实 例 。 大 多 数 MVC 应 用 程序 
被 部署 到 由 专业 管理 人 员 管 理 的 托管 环境 中 ， 因 此 
LocalDB 功 能 意味 看 数据 库 配 置 可 以 留 给 DBA 来 完 
成 ， 开 发 人 员 可 以 继续 进行 编码 。 
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fe ” 示 


如 果 在 安装 Visual Studio 时 没有 选择 LocalDB， 
IBA DE BBR, FY DAI Visual Studio zł 
程序 的 Individual Components 部 分 进行 选择 。 如 果 
按照 第 2 章 中 的 说 明 执 行 操作 ， 那 么 LocalDB 功 能 应 
该 已 经 安装 好 并 可 以 使 用 了 。 





8.4.1 ”安装 Entity Framework Core 工 具 包 


当 使 用 Visual Studio 创 建 项 目 时 ， 默 认 已 将 主 
要 的 Entity Framework Core 功 能 添加 到 项 目 中 。 你 
还 需要 一 个 额外 的 NuGet 包 来 提供 命令 行 工具 ， 这 
些 工 具 用 于 创建 一 些 类 ， 从 而 准备 数据 库 并 存储 应 
用 程序 的 数据 〈 称 为 迁移 ) 。 





要 将 包 添 加 到 项 目 中 ， 请 右 击 Solution Explorer 


窗 格 中 的 SportsStore 项 ， 从 弹出 亲 单 中 选择 Edit 

SportsStore.csproj， 然 后 根据 代码 清单 8-14 所 示 的 文 
件 进行 更 改 。 请 注意 ， 使 用 列表 中 指定 的 版 本 ， 并 
使 用 DotNetCliToolReference 元 素 添加 包 ， 而 不 是 使 





Fa PackageReferenceJt & © 


代码 清单 8-14 在 SportsStore 文 件 夹 下 的 SportsStore.csproj 文 件 
中 添加 包 


<Project Sdk="Microsoft.NET.Sdk.Web"> 


<PropertyGroup> 
<TargetFramework>netcoreapp2.0</TargetFramework> 


</PropertyGroup> 


<ItemGroup> 
<Folder Include="wwwroot\" /> 


</ItemGroup> 


<ItemGroup> 
<PackageReference Include="Microsoft.AspNetCore.All 


" Version="2.0.0" /> 
<DotNetCliToolReference Include="Microsoft.EntityFr 


ameworkCore.Tools .DotNet" 
Version="2.0.0" /> 
</ItemGroup> 


</Project> 
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必须 通过 编辑 文件 来 安装 这 个 包 。 这 种 类 型 的 
包 无 法 使 用 NuGet Package Manager 或 dotnet 命 令 行 
TRIT. 


当 保 存 文 件 时 ，Visual Studio 将 下 载 并 安装 
Entity Framework Core 命 令 行 工 具 ， 然 后 添加 到 项 
目 中 。 


8.4.2 ”创建 数据 库 类 


在 Models 文 件 夹 中 添加 名 为 


ApplicationDbContext.cs 的 类 文件 ， 并 定义 代码 清早 
8-15 所 示 的 类 。 数 据 库 上 下 文 类 (database context 
class) 是 应 用 程序 和 Entity Framework Core 之 则 的 
桥梁 ， 它 使 用 模型 对 象 提供 对 应 用 程序 数据 的 访 
问 。 为 了 创建 SportsStore 应 用 程序 的 数据 库 上 下 文 
类 ， 在 Models 文 件 夹 中 添加 名 为 
ApplicationDbContext.cs 的 类 文件 ， 并 定义 代码 清早 
8-15 所 示 的 类 。 


代码 清单 8-15 Models 文 件 夹 下 的 ApplicationDbContext.cs 文 件 
的 内 容 





using Microsoft.EntityFrameworkCore; 
using Microsoft.EntityFrameworkCore.Design; 
using Microsoft.Extensions.DependencyInjection; 


namespace SportsStore.Models { 
public class ApplicationDbContext : DbContext { 
public ApplicationDbContext (DbContextOptions<Ap 
plicationDbContext> options) 


: base(options) { } 


public DbSet<Product> Products { get; set; } 


} 


DbContext 基 类 提供 对 Entity Framework Corel’) 
底层 功能 的 访问 ，Products 属 性 将 提供 对 数据 库 中 
Product 对 象 的 访问 。ApplicationDbContext 类 从 
DbContext 派 生 ， 并 琴 加 了 一 些 属 性 ， 用 于 读 取 和 
写 入 应 用 程序 数据 。 目 前 只 有 一 个 属性 ， 它 将 提供 
对 Product 对 象 的 访问 。 





8.4.3 ”创建 存储 库 类 


目前 建立 数据 库 所 需 的 大 部 分 工作 已 完成 。 下 
一 步 是 创建 一 个 实现 了 IProductRepository 接口 并 
使 用 Entity Framework Core 获 取 数 据 的 类 。 在 
Models 文 件 夹 中 添加 名 为 EFProductRepository.cs 的 
关 文 件 ， 并 定义 代码 清单 8-16 所 示 的 存储 库 类 。 


代码 清单 8-16 Models 文 件 夹 下 的 EFProductRepository.cs 文 件 
的 内 容 


using System.Collections.Generic; 
using System.Ling; 


namespace SportsStore.Models { 


public class EFProductRepository : IProductReposito 
ry { 
private ApplicationDbContext context; 
public EFProductRepository(ApplicationDbContext 


ctx) { 


context = ctx; 


} 


public IQueryable<Product> Products => context. 
Products; 
} 
} 





这 里 将 回应 用 程序 添加 其 他 功能 ， 但 目前 ， 存 
储 库 实现 只 是 将 由 IProductRepository 接 口 定义 的 
Products 属 性 映射 到 由 ApplicationDbContext 类 定义 
的 Products 属 性 。 上 下 文 类 中 的 Products 属 性 会 返回 
一 个 DbSet <Product> 对 象 ， 该 对 象 实现 了 
IQueryable<T> 接 口 ， 并 且 在 使 用 Entity Framework 
Core 时 可 以 轻松 实现 IProductRepository 接 口 。 这 可 
以 确保 对 数据 库 的 但 询 将 只 检索 所 需 的 对 象 ， 如 本 
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8.4.4 定义 连接 字符 串 





连接 字符 串 〈connection string) 用 来 指定 数据 
库 的 位 置 和 名 称 ， 并 提供 应 用 程序 如 何 连接 到 数据 
库 服务 器 的 配置 设置 。 连 接 字 符 串 存储 在 名 为 
appsettings.json 的 JSON 文 件 中 ， 在 SportsStore 项 目 
中 ， 可 使 用 Add New Item 窗 口 的 General 部 分 的 
ASP.NET Configuration File 模 板 创 建 该 文件 。 





Visual Studio 在 创建 文件 时 会 同 appsettings.json 
文件 添加 占 位 符 连 接 字 符 串 ， 可 在 代码 清单 8-17 中 
BEITR HR 





代码 清单 8-17 编辑 SportsStore 文 件 夹 下 的 appsettings.json 文 件 
中 的 连接 字符 串 





"Data": { 
"SportStoreProducts": { 


"ConnectionString": "Server=(localdb)\\MSSQLLocal 
DB; Database=SportsStore;Trusted_Conne 
ction=True ;MultipleActiveResultSets=true" 





fe 示 








连接 字符 串 必 须 表示 为 完整 的 行 ， 这 在 Visual 
Studio 编 辑 右 中 是 没 问 题 的 ， 但 不 适合 图 书 版 面 ， 
因而 代码 清单 8-17 中 的 格式 比较 奇怪 。 当 在 目 己 的 
项 目 中 定义 连接 字符 串 时 ， 请 确保 ConnectionString 
的 值 位 于 同一 行 。 











在 配置 文件 的 Data 部 分 ， 已 将 连接 字符 串 的 名 


称 设 置 为 SportsStoreProducts。ConnectionString 的 值 
表示 应 将 LocalDB 功 能 用 于 名 为 SportsStore 的 数据 
库 。 


8.4.5 配置 应 用 程序 





接 下 来 的 步骤 是 谈 取 连接 字符 串 ， 并 配置 应 用 
程序 以 连接 到 数据 库 。 代 人 码 清单 8-18 显 示 了 对 
Startup 类 所 做 的 更 改 ， 以 接收 appsettings.json 文 件 
中 包含 的 配置 数据 的 详细 信息 ， 并 用 来 配置 Entity 
Framework Core〈 读 取 JSON 文 件 的 工作 由 Program 
类 处 理 ， 这 将 在 第 14 章 中 介绍 ) 。 





代码 清单 8-18 在 SportsStore 文 件 夹 下 的 Startup.cs 文 件 中 配置 
应 用 程序 





using System; 

using System.Collections.Generic; 
using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 
using Microsoft.AspNetCore.Hosting; 


using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using SportsStore.Models; 

using Microsoft.Extensions.Configuration; 

using Microsoft. EntityFrameworkCore; 


namespace SportsStore { 
public class Startup { 


public Startup(IConfiguration configuration) => 
Configuration = configuration; 


public IConfiguration Configuration { get; } 


public void ConfigureServices(IServiceCollectio 
n services) { 
services .AddDbContext<ApplicationDbContext> 
(options => 
options .UseSqlServer ( 
Configuration[ "Data:SportStoreProdu 
cts:ConnectionString"])); 
services.AddTransient<IProductRepository, E 
FProductRepository>(); 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes .MapRoute( 
name: "default", 
template: "{controller=Product}/{ac 


tion=List}/{id?}"); 
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appsettings.json 文 件 加 载 的 配置 数据 ， 该 文件 可 通 
过 实现 了 IConfiguration 接 口 的 对 象 来 呈现 。Startup 
构造 函数 将 IConfiguration 对 象 分 配给 名 为 
Configuration 的 属性 ， 以 便 Startup 类 的 其 余部 分 可 
以 使 用 。 





第 14 章 将 解释 如 何 读 取 和 访问 配置 数据 。 对 于 
SportsStore 应 用 程序 ， 添 加 一 系列 方法 调用 ， 用 于 
在 ConfigureServices 方 法 中 设置 Entity Framework 





Core. 


services .AddDbContext<ApplicationDbContext>(options => 


options .UseSqlServer(Configuration[ "Data:SportStore 
Products:ConnectionString"])); 





AddDbContext 扩 展 方法 用 于 为 代码 清单 8-15 中 
创建 的 数据 库 上 下 文 类 设置 由 Entity Framework 
Core 提 供 的 服务 。 正 如 在 第 14 章 中 解释 的 那样 ， 在 
Startup 类 中 使 用 的 许多 方法 允许 使 用 选项 参数 来 配 
置 服务 和 中 间 件 功能 。AddDbContext 方 法 的 参数 是 
一 个 Lambda 表 达 式 ， 它 接收 为 上 下 文 类 配置 数据 库 
的 可 选 对 象 。 在 这 种 情况 下 ， 使 用 UseSqlServer 方 
法 配置 数据 库 ， 并 指定 从 Configuration 属 性 获取 的 
连接 字符 串 。 














在 Startup 类 中 做 出 的 下 一 个 更 改 是 用 真实 存储 
库 符 换 虚 拟 存储 库 ， 如 下 所 示 : 


services.AddTransient<IProductRepository, EFProductRepo 





sitory>(); 


使 用 了 IProductRepository 接 口 的 应 用 程序 中 的 
ZH CA BR Product} till as) 将 在 创建 时 接收 


EFProductRepository 对 象 ， 从 而 使 它们 可 以 访问 数 
据 库 中 的 数据 。 第 18 章 将 详细 解释 这 是 如 何 工作 
的 ， 结 果 是 模拟 数据 将 被 数据 库 中 的 真实 数据 无 颖 
蔡 换 ， 而 无 顷 更 改 ProductController 类 。 








茶 用 范围 验证 


使 用 Entity Framework Core 需 要 对 依赖 注入 功 
能 的 配置 进行 更 改 ， 具 体 方 法 将 在 第 18 划 中 介绍 。 
在 将 控制 权 交 给 Startup 类 之 前 ，Program 类 负责 局 
动 和 配置 ASP.NET Core， 代 人 码 清单 8-19 显 示 了 需要 
执行 的 更 改 。 如 末 不 做 更 改 ， 那 么 在 答 试 创建 数据 
FEAR RIBS S| AFR AB o 








代码 清单 8-19 在 SportsStore 文 件 夹 下 的 Program.cs 文 件 中 准备 
使 用 Entity Framework Core 





using System; 

using System.Collections.Generic; 
using System. IO; 

using System. Linq; 


using System.Threading.TasKs ; 
using Microsoft.AspNetCore; 
using Microsoft.AspNetCore.Hosting; 
using Microsoft.Extensions.Configuration; 
using Microsoft.Extensions.Logging; 
namespace SportsStore { 

public class Program { 

public static void Main(string[] args) { 
BuildWebHost(args).Run(); 


} 


public static IWebHost BuildWebHost(string[] ar 
gs) => 


WebHost.CreateDefaultBuilder(args) 
.UseStartup<Startup>() 
.UseDefaultServiceProvider(options => 

options.ValidateScopes = false) 
.Build(); 





第 14 章 将 解释 如 何 详细 配置 ASP.NET Core, 但 
这 是 SportsStore 应 用 程序 所 需 的 对 Program 关 要 做 的 
唯一 更 改 。 


8.4.6 ”创建 数据 库 迁 移 


Entity Framework Core 能 够 通过 称 为 迁移 


(migration〉 的 功能 ， 使 用 模型 类 生成 数据 库 染 
构 。 准 备 迁 移 时 ，Entity Framework Core 会 创建 一 
个 包含 准备 数据 库 所 需 的 SQL 命 令 的 C# 类 。 如 果 雷 
要 修改 模型 类 ， 则 可 以 创建 一 个 新 的 迁移 ， 其 中 包 
含有 反映 更 改 所 需 的 SQL 命 令 。 通 过 这 种 方式 ， 不 必 
担心 手动 编写 和 测试 SQL 命 令 ， 而 只 需 关 注 应 用 程 
序 中 的 C# 模 型 类 。 





Entity Framework Core 命 令 从 命令 行 执 行 。 打 
开 一 个 新 的 命令 提示 符 或 PowerShell 窗 口 ， 导 航 到 
SportsStore 项 目 文 件 夹 (包含 Startup.cs 和 
appsettings.json 文 件 的 文件 来 )》， 然 后 运行 以 下 命 
令 来 创建 迁移 类 ， 以 准备 第 一 次 使 用 数据 库 : 


dotnet ef migrations add Initial 


执行 完 以 上 命令 后 ， 你 将 在 Visual Studio) 
Solution Explorer 窗 格 中 看 到 Migrations 文 件 严 ， 这 


是 Entity Framework Core 存 储 其 迁移 类 的 地 方 。 其 
中 一 个 文件 名 将 是 一 个 时 间 戳 ， 后 跟 _Initial.cs， 这 
是 用 于 为 数据 库 创建 初始 架构 的 类 。 如 果 但 看 此 文 
件 的 内 容 ， 可 以 看 到 如 何 使 用 Product 模 型 类 来 创建 
数据 库 染 构 。 


Add-Migration 和 Update-Database 命 令 


对 于 经 验 丰 富 的 Entity Framework 开 发 者 ， 则 
可 能 习惯 使 用 Add-Migration 命 令 来 创建 数据 库 迁 
移 ， 并 使 用 Update-Database 命 令 将 其 应 用 于 数据 
库 。 


bi 44.NET Core 的 推出 ，Entity Framework Core 
庄 加 了 集成 到 dotmet 命 令 行 工具 的 命令 ， 可 通过 添 
加 到 代码 清单 8-14 中 的 
Microsoft.EntityFrameworkCore.Tools.DotNet 软 件 包 





REA. ARMED HS, ALA ESR 

他 .NET 命 令 一 致 ， 可 以 在 任何 命令 提示 符 或 
PowerShell 窗 口中 使 用 ， 而 不 像 Add-Migration 和 
Update-Database 命 令 ， 它 们 仅 在 特定 Visual Studio 


窗口 中 使 用 。 


8.4.7 ”创建 种 子 数据 


为 了 填充 数据 库 并 提供 一 些 示 例 数 据 ， 在 
Models 文 件 夹 中 添加 名 为 SeedData.cs 的 类 文件 ， 并 
定义 代码 清单 8-20 所 示 的 类 。 


代码 清单 8-20 Models 文 件 夹 下 的 SeedData.cs 文 件 的 内 容 





using System. Linq; 

using Microsoft.AspNetCore.Builder; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.EntityFrameworkCore; 


namespace SportsStore.Models { 


public static class SeedData { 


public static void EnsurePopulated(IApplication 
Builder app) { 
ApplicationDbContext context = app.Applicat 
ionServices 
.GetRequiredService<ApplicationDbContex 


t>(); 
context.Database.Migrate() ; 
if (!context.Products.Any()) { 
context.Products .AddRange( 
new Product { 
Name = "Kayak", Description = " 
A boat for one person", 
Category = "Watersports", Price 
= 275 }, 
new Product { 
Name = "Lifejacket", 
Description = "Protective and f 
ashionable", 
Category = "Watersports", Price 
= 48.95m }, 
new Product { 
Name = "Soccer Ball", 
Description = "FIFA-approved si 
ze and weight", 
Category = "Soccer", Price = 19 
.50m }, 
new Product { 
Name = "Corner Flags", 
Description = "Give your playin 
g field a professional touch", 
Category = "Soccer", Price = 34 
.95m }, 


new Product { 
Name = "Stadium", 


60-seat stadium", 


500 }, 

new 
ficiency by 75%", 
Jo 

new 


Description = "Flat-packed 35,0 


Category = "Soccer", Price = 79 
Product { 

Name = “Thinking Cap", 
Description = "Improve brain ef 


Category = "Chess", Price = 16 


Product { 
Name = "Unsteady Chair", 
Description = "Secretly give yo 


ur opponent a disadvantage", 


95m }, 
new 
he family", 
Fs 
new 
mond-studded King", 
0 
} 
); 
context. 


Category = "Chess", Price = 29. 


Product { 
Name = "Human Chess Board", 
Description = "A fun game for t 


Category = "Chess", Price = 75 
Product { 

Name = "Bling-Bling King", 
Description = "Gold-plated, dia 


Category = "Chess", Price = 120 


SaveChanges(); 





静态 的 EnsurePopulated 方 法 会 接收 
IApplicationBuilder 参 数 ， 该 参数 是 Startup 关 的 
Configure 方 法 中 使 用 的 接口 ， 用 来 注册 中 间 件 以 处 
理 HITP 请 求 ， 这 是 确保 数据 库 具 有 内 容 的 地 方 。 








EnsurePopulated 方 法 通过 IApplicationBuilder 接 
口 获取 ApplicationDbContext 对 象 ， 并 调用 
Database.Migrate 方 法 以 确保 已 应 用 迁移 ， 这 意味 痢 
将 创建 和 准备 数据 库 ， 以 便 可 以 存储 Product 对 象 。 
接 下 来 ， 检 得 数据 库 中 Product 对 象 的 数量 。 如 果 数 
据 库 中 没有 对 象 ， 则 使 用 AddRange 方 法 ， 用 一 组 
Product 对 象 填 充 数 据 库 ， 然 后 使 用 SaveChanges 方 
法 将 它们 写 入 数据 库 。 


最 后 的 更 改 古 在 应 用 程序 启动 时 对 数据 库 填充 
种 子 数 据 ， 可 通过 从 Startup 类 中 调用 
EnsurePopulated 方 法 来 完成 ， 如 代码 清 日 8-21 所 
Ae 





代码 清单 8-21 在 SportsStore 文 件 夹 下 的 Startup.cs 文 件 中 对 数 
据 库 填充 种 子 数据 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using SportsStore.Models; 

using Microsoft.Extensions.Configuration; 
using Microsoft.EntityFrameworkCore; 


namespace SportsStore { 
public class Startup { 


public Startup(IConfiguration configuration) => 
Configuration = configuration; 


public IConfiguration Configuration { get; } 
public void ConfigureServices(IServiceCollectio 
n services) { 
services .AddDbContext<ApplicationDbContext> 
(options => 
options.UseSqlServer ( 
Configuration|[ "Data:SportStoreProdu 
cts:ConnectionString"])); 
services.AddTransient<IProductRepository, E 
FProductRepository>() ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes .MapRoute( 
name: "default", 
template: "{controller=Product}/{ac 


tion=List}/{id?}"); 
}); 
SeedData.EnsurePopulated(app) ; 





局 动 应 用 程序 ， 创 建 数 据 库 并 为 其 填充 种 子 数 
据 ， 用 于 回应 用 程序 提供 数据 《请 耐心 等 待 ， 可 能 
需要 一 些 时 间 才 能 创建 数据 库 ) 。 


当 浏 览 器 请 求 应 用 程序 的 默认 URL 时 ， 应 用 程 
序 配 置 告知 MVC 需 要 创建 一 个 Product 控 制 右 来 处 
理 请求 。 创 建新 的 Product 控 制 器 意味 着 调用 
ProductController 构 造 函 数 ， 访 构造 亢 数 需要 一 个 实 
现 了 IProductRepository 接 口 的 对 象 ， 新 的 配置 告诉 


MVC 应 该 为 此 创建 并 使 用 EFProductRepository 对 
象 。EFProductRepository 对 象 利 用 Entity Framework 
Core 功 能 ， 从 SQL Server 加 载 数 据 并 将 其 转换 为 
Product 对 象 。 所 有 这 些 对 ProductController 类 都 是 
隐 藏 的 ， 该 类 只 接收 一 个 实现 了 IProductRepository 
接口 的 对 象 ， 并 使 用 其 提供 的 数据 。 结 果 是 在 浏览 
器 中 显示 数据 库 中 的 样本 数据 ， 如 图 8-8 所 示 。 





Lifejacket 


Protective and fashionable 
$48.95 

Soccer Ball 

FIFA-approved size and weight 


$1950 
p on ht 


图 8-8 数据 库 中 的 样本 数据 


这 种 让 Entity Framework Core 将 SQL Server 数 气 
库 呈 现 为 一 系列 模型 对 象 的 方法 非常 简单 且 易 于 使 





用 ， 使 你 能 够 将 注意 力 集中 在 ASP.NET Core MVC 
上 ， 从 而 跳 过 Entity Framework Core 运 行 的 大 量 细 
节 以 及 可 用 的 大 量 配置 选项 。 作 者 非常 喜欢 Entity 
Framework Core， 建 议 你 花 一 些 时 间 详 细 了 解 它 。 
一 个 很 好 的 起 点 是 微软 的 Entity Framework Core) 
站 。 








8.5 添加 分 页 





从 图 8-8 可 以 看 出 ，List.cshtml 视 图 文件 在 单个 
页 面 上 显示 了 数据 库 中 的 产品 。 在 本 节 中 ， 将 添加 
对 分 页 的 支持 ， 以 便 视 图 在 页 面 上 显示 较 少 数量 的 
产品 ， 用 户 可 以 翻 页 得 看 全 部 目录 。 为 此 ， 在 
Product 控制 占有 的 List 方 法 中 添加 一 个 参数 ， 如 代码 
清单 8-22 所 示 。 

















代码 清单 8-22 ”在 Controller 文 件 严 下 ， 为 ProductController.cs 
文件 中 名 为 List 的 操作 方法 添加 分 页 支持 


using Microsoft.AspNetCore.Mvc; 
using SportsStore.Models; 

using System.Ling; 

namespace SportsStore.Controllers { 


public class ProductController : Controller { 
private IProductRepository repository; 
public int PageSize = 4; 


public ProductController(IProductRepository rep 
o) { 


repository = repo; 


} 


public ViewResult List(int productPage = 1) 
=> View(repository.Products 
-OrderBy(p => p.ProductID) 
-Skip((productPage - 1) * PageSize) 
. Take(PageSize) ); 








PageSize 字 段 指 定 每 页 需要 4 个 产品 。 这 里 回 
List 方 法 添加 了 一 个 可 选 参 数 ， 从 而 意味 着 如 果 调 
用 没有 参数 的 方法 (Listl) ， 调 用 将 被 视 为 已 经 提 
供 了 参数 定义 中 指定 的 值 (List (1) ) 。 结 果 是 ， 
当 MVC 调 用 不 带 参数 的 List 方 法 时 ， 将 显示 产品 的 
第 一 页 。 在 操作 方法 的 主体 中 ， 得 到 了 Product 对 











象 ， 可 通过 主键 对 它们 进行 排序 ， 跳 过 当前 页 面 之 
前 出 现 的 产品 ， 并 获取 PageSize 字 段 指 定 的 产品 数 


H. 


HÆ o 


单元 测试 





分 页 


可 以 通过 创建 模拟 的 存储 库 ， 再 注入 
ProductController 类 的 构造 函数 ， 并 调用 List 方 法 来 
请 求 特定 的 页 面 来 对 分 页 功能 进行 单元 测试 。 然 
后 ， 可 以 对 得 到 的 Product 对 象 与 期 望 从 模拟 实现 的 
测试 数据 中 得 到 的 结果 进行 比较 。 有 关 如 何 设置 单 
元 测试 的 详细 信息 ， 请 参阅 第 7 章 。 这 里 是 为 此 创 
建 的 单元 测试 ， 已 琴 加 到 SportsStore 项 目的 名 为 
ProductControllerTests.cs 的 类 文件 中 。 








using System.Collections.Generic; 
using System.Ling; 
using Mog; 


using SportsStore.Controllers; 
using SportsStore.Models; 
using Xunit; 


namespace SportsStore.Tests { 
public class ProductControllerTests { 


[Fact] 
public void Can_Paginate() { 
// Arrange 
Mock<IProductRepository> mock = new Mock<IP 
roductRepository>() ; 
mock.Setup(m => m.Products).Returns((new Pr 


oduct[] { 

new Product {ProductID = 1, Name = "P1" 
Jo 

new Product {ProductID = 2, Name = "P2" 
Jo 

new Product {ProductID = 3, Name = "P3" 
Jo 

new Product {ProductID = 4, Name = "P4" 
Jo 

new Product {ProductID = 5, Name = "P5" 
} 


}) .AsQueryable<Product>()); 


ProductController controller = new ProductC 
ontroller(mock.Object) ; 
controller.PageSize = 3; 


// Act 
ITEnumerable<Product> result = 
controller.List(2).ViewData.Model as IE 
numerable<Product>; 


// Assert 

Product[] prodArray = result.ToArray(); 
Assert.True(prodArray .Length == 2); 
Assert.Equal("P4", prodArray[@].Name) ; 
Assert.Equal("P5", prodArray[1].Name) ; 





从 操作 方法 返回 的 数据 不 太 好 处 理 。 结 果 是 一 
个 ViewResult 对 象 ， 必 须 将 ViewData.Model 属 性 的 
值 转换 为 预期 的 数据 类 型 。 第 17 章 将 解释 由 操作 方 
法 返回 的 不 同 结果 类 型 以 及 如 何 使 用 它们 。 








8.5.1 显示 页 面 链接 


如 果 运 行 应 用 程序 ， 你 将 看 到 页 面 上 显示 了 4 
个 条 目 。 如 果 要 合 看 其 他 页 面 ， 可 以 将 查询 字符 蝇 
参数 附加 到 URL 的 末尾 ， 如 下 所 示 : 


http://localhost:50600600/?productPpage=2 


你 需要 更 改 URL 的 痛 口 部 分 ， 以 匹配 项 目 使 用 
的 端口 。 使 用 这 些 郁 询 字 符 串 ， 可 以 浏 贤 产 品目 
Ko 











客户 无 法 确定 这 些 得 询 字 符 串 参数 是 否 存 在 ， 
即使 它们 存在 ， 也 不 会 以 这 种 方式 导航 。 相 反 ， 需 
要 在 每 个 产品 列表 的 底部 呈现 一 些 页 面 链 接 ， 以 便 
客户 可 以 在 页 面 之 间 导 航 。 为 了 做 到 这 一 点 ， 需 要 
实现 一 个 标签 助手 (tag helper) ， 它 可 以 为 所 需 链 
接生 成 HTML 标 记 。 











1. 添加 视图 模型 





为 了 使 用 标签 助手 ， 需 要 癌 视 图 传递 可 用 页 面 
的 数量 、 当 前 页 面 以 及 存储 库 中 产品 总 数 的 信息 。 
最 简单 的 方法 是 创建 视图 模型 类 ， 专 门 用 于 在 控制 
器 和 视图 之 间 传 递 数据 。 在 SportsStore 项 目 中 创建 
Models/ViewModels 文 件 夹 ， 并 添加 名 为 

















PagingImnfo.cs 的 类 文件 ， 如 代码 清单 8-23 所 示 。 


代码 清单 8-23 ”Models/ViewModels 文 件 夹 下 的 PagingInfo.cs 文 
件 的 内 容 


using System; 


namespace SportsStore.Models.ViewModels { 


public class PagingInfo { 
public int TotalItems { get; set; } 
public int ItemsPerPage { get; set; } 
public int CurrentPage { get; set; } 


public int TotalPages => 
(int)Math.Ceiling((decimal)TotalItems / Ite 
msPerPage) ; 





现在 已 经 有 了 视图 模型 ， 接 下 来 可 以 创建 标签 
助手 类 。 在 SportsStore 项 目 中 创建 Infrastructure 文 件 
夹 ， 并 添加 名 为 PageLinkTagHelper.cs 的 类 文件 ， 访 
文件 用 于 定义 代码 清单 8-24 所 示 的 类 。 标 俭 助手 是 











ASP.NET Core MVC 的 重要 组 成 部 分 ， 第 23 一 25 章 
将 解释 它们 的 工作 原理 以 及 如 何 创建 它们 。 


代码 清单 8-24 Infrastructure 文件 夹 下 的 PageLinkTagHelper.cs 
文件 的 内 容 





using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.Rendering; 
using Microsoft.AspNetCore.Mvc.Routing; 
using Microsoft.AspNetCore.Mvc.ViewFeatures; 
using Microsoft.AspNetCore. Razor. TagHelpers; 
using SportsStore.Models.ViewModels ; 


namespace SportsStore.Infrastructure { 


[HtmlTargetElement("div", Attributes = "page-model" 


)] 
public class PageLinkTagHelper : TagHelper { 


private IUrlHelperFactory urlHelperFactory; 
public PageLinkTagHelper(IUrlHelperFactory help 


erFactory) { 
urlHelperFactory = helperFactory; 


} 


[ViewContext] 
[HtmlAttributeNotBound] 


public ViewContext ViewContext { get; set; } 


public PagingInfo PageModel { get; set; } 


public string PageAction { get; set; } 


public override void Process(TagHelperContext c 
ontext, 
TagHelperOutput output) { 
IUrlHelper urlHelper = urlHelperFactory.Get 
UrlHelper(ViewContext) ; 
TagBuilder result = new TagBuilder("div"); 
for (int i = 1; i <= PageModel.TotalPages; 
i++) { 
TagBuilder tag = new TagBuilder("a"); 
tag.Attributes["href"] = urlHelper.Acti 
on(PageAction, 
new { productPage = i }); 
tag.InnerHtml.Append(i.ToString()); 
result. InnerHtml.AppendHtml (tag) ; 


} 
output. Content.AppendHtml (result. InnerHtm1 ) 








Infrastructure 文 件 夹 是 放置 为 应 用 程序 提供 基 
础 设施 的 类 的 地 方 ， 这 些 类 与 应 用 程序 的 域 无 关 。 





标签 助手 使 用 与 产品 页 面 对 应 的 元 素 填 充 div 
元 素 。 现 在 不 会 详细 介绍 标签 助手 ， 知 道 它们 是 可 
以 将 C# 人 逻辑 引入 视图 的 最 有 用 方法 之 一 束 足 够 了 。 
标签 助手 的 代码 可 能 会 比较 难 懂 ， 因 为 C# 和 HTML 
不 容易 混合 。 但 是 使 用 标签 助手 要 比 在 视图 中 包含 
C# 代 人 码 块 好 一 些 ， 因 为 标签 助手 可 以 轻松 进行 单元 
测试 。 











大 多 数 MVC 组 件 〈( 如 控制 器 和 视图 ) 可 以 直 
接 使 用 ， 但 标签 助手 必须 先 注 册 。 在 代码 清单 8-25 
中 ， 在 Views 文 件 夹 下 的 _ViewImports.cshtml 文 件 中 
添加 一 条 语句 ， 告 诉 MVC 在 
SportsStore.Infrastructure 命 名 空间 中 查找 标签 助手 


类 。 这 里 还 添加 了 一 个 @using 表 达 式 ， 以 便 可 以 引 
用 视图 中 的 视图 模型 类 ， 而 无 须 使 用 命名 空间 限定 
名 称 。 


代码 清单 8-25 ”在 Views/Shared 文 件 夹 下 的 ViewImports.cshtml 
文件 中 注册 一 个 标签 助手 


@using SportsStore.Models 
@using SportsStore.Models.ViewModels 


@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 
@addTagHelper SportsStore.Infrastructure.*, SportsStore 





单元 测试 一 一 创建 分 页 链接 





为 了 测试 PageLinkTagHelper 标 签 助手 类 ， 可 使 
用 测试 数据 调用 Process 方 法 ， 并 提供 
TagHelperOutput 对 象 ， 以 玛 看 生成 的 HIML， 如 下 
所 示 ， 在 SportsStore 项 目的 
PageLinkTagHelperTests.cs 文 件 中 定义 了 这 些 内 
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using System.Collections.Generic; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.Routing; 
using Microsoft.AspNetCore. Razor. TagHelpers; 
using Moq; 

using SportsStore.Infrastructure; 

using SportsStore.Models.ViewModels ; 

using Xunit; 


namespace SportsStore.Tests { 
public class PageLinkTagHelperTests { 


[Fact] 
public void Can_Generate_Page_Links() { 
// Arrange 
var urlHelper = new Mock<IUrlHelper>() ; 
urlHelper.SetupSequence(x => x.Action(It.Is 
Any<UrlActionContext>())) 
.Returns("Test/Page1" ) 
.Returns("Test/Page2" ) 
.Returns("Test/Page3") ; 


var urlHelperFactory = new Mock<IUrlHelperF 
actory>(); 
urlHelperFactory.Setup(f => 
f .GetUrlHelper (It. IsAny<ActionConte 


xt>())) 
.Returns(urlHelper.Object) ; 


PageLinkTagHelper helper = 


new PageLinkTagHelper (urlHelperF 
actory.Object) { 
PageModel = new PagingInfo { 
CurrentPage = 2, 
TotalItems = 28, 
ItemsPerPage = 10 


Jo 
PageAction = "Test" 
}; 
TagHelperContext ctx = new TagHelperContext 
( 
new TagHelperAttributeList(), 
new Dictionary<object, object>(), ""); 
var content = new Mock<TagHelperContent>() ; 
TagHelperOutput output = new TagHelperOutpu 
t( "div", 


new TagHelperAttributeList(), 
(cache, encoder) => Task.FromResult(con 
tent .Object) ) ; 


// Act 
helper.Process(ctx, output) ; 


// Assert 
Assert.Equal(@"<a href=""Test/Page1"">1</a> 


+ @"<a href=""Test/Page2"">2</a>" 
+ @"<a href=""Test/Page3"">3</a>", 
output.Content.GetContent()); 





以 上 测试 的 复杂 性 在 于 创建 一 些 对 象 ， 用 来 创 
建 和 使 用 标签 助手 。 标 签 助 手 使 用 
IUrlHelperFactory 对 象 来 生成 针对 应 用 程序 不 同 部 
分 的 URL， 并 且 已 经 使 用 Moq 来 创建 对 应 接口 的 实 
现 ， 以 及 提供 测试 数据 的 IUrlHelper 接 口 。 











ee 包含 双 引 号 的 字 
符 串 来 验证 标签 助手 的 输出 。 字符 串 的 前 级 为 
en 
很 好 地 处 理 这 些 字 符 串 。 记 住 ， 不 要 将 字符 串 分 割 
成 单独 的 行 ， 除 非 希 望 拆散 正在 比较 的 字符 串 。 例 
如 ， 在 测试 方法 中 使 用 的 字符 串 已 经 被 换行 了 ， 因 
为 打印 页 面 的 宽度 很 窄 。 这 里 没有 添加 换行 符 ， 如 
果 这 样 做 ， 测 试 将 会 失败 。 











3. 添加 视图 模型 数据 


为 了 使 用 标签 助手 ， 还 需要 为 视图 提供 
PagingInfo 视 图 模型 类 的 实例 。 使 用 view bag pen 
以 做 到 这 一 点 ， 但 是 作者 党 把 控制 颖 发 送 的 所 有 数 
据 包 闭 到 单个 视图 模型 美的 视图 中 。 为 此 ， 将 一 个 
名 为 ProductsListViewModel.cs 的 类 文件 添加 到 
SportsStore 项 目的 Models/ViewModels 文 件 夹 中 ， 代 
码 清单 8-26 显 示 了 这 个 文件 的 内 容 。 

















代码 清单 8-26 ”Models/ViewModels 文 件 夹 下 的 
ProductsListViewModel.cs 文 件 的 内 容 


using System.Collections.Generic; 
using SportsStore.Models; 


namespace SportsStore.Models.ViewModels { 


public class ProductsListViewModel { 
public IEnumerable<Product> Products { get; set 


public PagingInfo PagingInfo { get; set; } 





可 以 更 新 ProductController 类 中 的 List 操 作 方法 





来 使 用 ProductsListViewModel 类 ， 以 提供 页 面 上 显 
示 的 产品 的 详细 信息 以 及 分 页 的 详细 信息 ， 如 代码 
清单 8-27 所 示 。 


代码 清单 8-27 更 新 Controllers 文 件 夹 下 的 ProductController.cs 
文件 中 的 List 操 作 方 法 





using Microsoft.AspNetCore.Mvc; 
using SportsStore.Models; 

using System.Ling; 

using SportsStore.Models.ViewModels ; 


namespace SportsStore.Controllers { 


public class ProductController : Controller { 
private IProductRepository repository; 
public int PageSize = 4; 
public ProductController(IProductRepository rep 


repository = repo; 


} 


public ViewResult List(int productPage = 1) 
=> View(new ProductsListViewModel { 

Products = repository.Products 
.OrderBy(p => p.ProductID) 
-Skip((productPage - 1) * PageSize) 
.Take(PageSize), 

PagingInfo = new PagingInfo { 
CurrentPage = productPage, 


ItemsPerPage = PageSize, 
TotalItems = repository.Products.Co 








这 些 更 改 会 将 ProductsListViewModel 对 象 作为 
模型 数据 传递 给 视图 。 





单元 测试 一 一 分 足 模 型 视图 数据 


以 下 是 在 测试 项 目 中 添加 到 
ProductControllerTests 类 的 单元 测试 ， 以 确保 控制 
髓 将 正确 的 分 页 数据 发 送 到 视图 : 





[Fact] 
public void Can Send Pagination View Model() { 


// Arrange 
Mock<IProductRepository> mock = new Mock<IProductRe 
pository>(); 


mock.Setup(m => m.Products).Returns((new Product[ ] 


{ 

new Product {ProductID = 1, Name = "P1"}, 
new Product {ProductID = 2, Name = "P2"}, 
new Product {ProductID = 3, Name = "P3"}, 
new Product {ProductID = 4, Name = "P4"}, 
new Product {ProductID = 5, Name = "P5"} 

}) .AsQueryable<Product>()); 

// Arrange 

ProductController controller = 
new ProductController(mock.Object) { PageSize = 

3 }; 


// Act 
ProductsListViewModel result = 
controller.List(2).ViewData.Model as ProductsLi 
stViewModel ; 


// Assert 

PagingInfo pageInfo = result.PagingInfo; 
Assert.Equal(2, pageInfo.CurrentPage) ; 
Assert.Equal(3, pageInfo.ItemsPerPage) ; 
Assert.Equal(5, pageInfo.Totalitems) ; 
Assert.Equal(2, pageInfo.TotalPages) ; 





还 需要 修改 早期 的 包含 在 Can_Paginate 方法 中 
的 分 页 单元 测试 。 它 依赖 List 操作 方法 返回 一 1 
ViewResult， 其 Model 属 性 是 Product 对 象 的 序列 ， 


并 且 和 需要 将 数据 包含 在 男 一 视图 模型 类 型 中 。 下 面 
是 修改 后 的 测试 : 








[Fact] 
public void Can_Paginate() { 

// Arrange 

Mock<IProductRepository> mock = new Mock<IProductRe 
pository>(); 

mock.Setup(m => m.Products).Returns((new Product[ ] 


{ 
new Product {ProductID 


new Product {ProductID 
new Product {ProductID 
new Product {ProductID 
new Product {ProductID 
}) .AsQueryable<Product>()); 


» Name = "P1"}, 
» Name = "P2"}, 
Name = "P3"}, 
» Name = "P4"}, 
» Name = "P5"} 


ll 
wm 上 ww PR 
v 


ProductController controller = new ProductControlle 
r(mock.Object); 
controller.PageSize = 3; 


// Act 
ProductsListViewModel result = 
controller.List(2).ViewData.Model as ProductsLi 
stViewModel; 


// Assert 

Product[] prodArray = result.Products.ToArray(); 
Assert.True(prodArray.Length == 2); 
Assert.Equal("P4", prodArray[0].Name) ; 
Assert.Equal("P5", prodArray[1].Name) ; 


... 


考虑 到 这 两 种 测试 方法 之 间 存 在 重复 ， 通 常会 
创建 一 种 通用 的 设置 方法 。 





由 于 视图 目前 期 望 得 到 Product 对 象 序列 ， 因 此 
需要 更 新 List.cshtml 文 件 ， 如 代码 清单 8-28 所 示 ， 
以 处 理 新 的 视图 模型 类 型 。 





代码 清单 8-28 ”更 新 Views/Product 文 件 夹 下 的 List.cshtml 文 件 


@model ProductsListViewModel 


@foreach (var p in Model.Products) { 
<div> 


<h3>@p.Name</h3> 


@p .Description 


<h4>@p.Price.ToString("c")</h4> 
</div> 








这 里 已 经 更 新 了 @model 指 令 ， 以 告诉 Razor 现 





在 正在 使 用 不 同 的 数据 类 型 。 此 外 ， 还 更 新 了 
foreach 循 环 ， 因 此 数据 源 要 改 为 模型 数据 的 
Products 属 性 。 


A. 显示 分 页 链接 





现在 ， 将 页 面 链接 添加 到 列表 视图 所 需 的 代码 
已 经 写 完 ， 创 建 了 包含 分 由 信息 的 视图 模型 ， 更 新 
了 控制 器 以 便 将 信息 传递 给 视图 ， 还 更 改 了 
@model 指 令 以 匹配 新 的 模型 视图 类 型 。 剩 下 的 就 
是 添加 由 标签 助手 生成 的 用 于 创建 页 面 链 接 的 
HTMEL 元 系 ， 如 代码 清单 8-29 所 示 。 





代码 清单 8-29 在 Views/Product 文 件 夹 下 的 Listcshtml 文 件 中 
添加 分 页 链接 





@model ProductsListViewModel 


@foreach (var p in Model.Products) { 
<div> 
<h3>@p.Name</h3> 
@p .Description 


<h4>@p.Price.ToString("c")</h4> 
</div> 


} 


<div page-model="@Model.PagingInfo" page-action="List"> 
</div> 





如 采 运 行 应 用 程序 ， 你 将 看 到 新 的 页 面 链接 ， 
如 图 8-9 所 示 。 使 用 的 还 是 基本 的 样式 ， 这 将 在 本 
章 的 后 面 修正 。 现 在 重要 的 是 ， 新 的 链接 使 用 户 能 
人 够 翻 页 探索 要 销售 的 产品 。 当 Razor 在 div 元 系 上 找 
到 page-model 属 性 时 ， 要 求 PageLinkTagHelper 类 转 
换 元 素 ， 进 而 产生 图 8-9 所 示 的 一 组 链接 。 














Flat-packed 35,000-seat stadi 
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Unsteady Chair 
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图 8-9 页面 导航 链接 


为 什么 不 使 用 GridView? 


如 果 以 前 曾经 使 用 过 ASP.NET， 那 么 可 能 会 认 
为 这 是 再 普通 不 过 的 结果 。 如 果 使 用 的 是 Web 密 
体 ， 那 么 可 以 通过 ASP.NET Web Forms 的 GridView 
或 ListView 控 件 ， 和 直接 连接 到 Products 数 据 表 ， 完 成 
相同 的 操作 。 


本 章 完成 的 内 容 可 能 看 起 来 不 是 很 多 ， 但 与 将 
控件 拖 到 设计 界面 上 相 比 有 根本 的 区 别 。 首 先 ， 这 
里 正在 创建 一 个 共有 可 徘 和 可 维护 性 架构 的 应 用 程 
序 ， 涉 及 关注 点 分 离 问 题 。 与 简单 地 使 用 ListView 
控件 不 同 ， 没 有 直接 耦合 UI 和 数据 库 ， 虽 然 这 可 以 
快速 得 到 结 末 ， 但 随 独 时 间 的 推移 会 产生 很 多 问 
题 。 其 次 ， 这 里 一 直 在 创建 单元 测试 ， 硕 望 能 够 以 


一 种 目 然 的 方式 验证 应 用 程序 的 行为 ， 这 对 于 复杂 
的 Web Forms 控 件 几 乎 是 不 可 能 的 。 最 后 ， 请 记 
住 ， 本 章 已 经 介绍 了 很 多 内 容 来 创建 正在 构建 的 应 
用 程序 的 基础 架构 。 定 义 和 实 现存 储 库 即 可 。 例 
如 ， 现 在 可 以 快速 、 轻 松 地 构建 和 测试 新 功能 。 


当然 ， 正 如 第 3 章 解 释 的 那样 ， 即 使 在 大 型 复 
杂项 目 中 ， 即 时 展示 数据 可 能 郧 贯 且 很 痛 吾 ， 但 所 
有 这 些 者 不 会 掩 凋 如 下 事实 ， 即 Web 窗 体 可 以 快速 
HB ML ZN BGR 








8.5.2 ”改进 URL 


现在 页 面 链 接 可 以 正常 工作 ， 但 它们 仍然 使 用 
伍 询 字符 串 将 页 面 信息 传递 到 服务 器 ， 如 下 所 示 : 


http://localhost/ ?productPage=2 





可 通过 创建 一 种 遵循 可 组 合 网 址 模式 的 方案 ， 
得 到 更 具 吸 引力 的 URL。 可 组 合 的 URL 是 对 用 户 有 
意义 的 URL， 就 像 下 面 这 样 : 


http://localhost/Page2 


MVC 可 以 轻松 地 更 改 应 用 程序 中 的 URL 结 
构 ， 因 为 它 使 用 了 ASP.NET 路 由 功能 ， 该 功能 负责 
处 理 URL， 以 确定 要 访问 应 用 程序 的 哪 一 部 分 。 你 
需要 做 的 是 ， 当 你 在 Startup 类 的 Configure 方 法 中 注 
册 MVC 中 间 件 时 ， 添 加 一 个 新 的 路 由 ， 如 代码 清单 
8-30 所 示 。 





A 


代码 清单 8-30 在 SportsStore 文 件 夹 下 的 Startup.cs 文 件 中 还 加 
一 个 新 的 路 由 





using System; 

using System.Collections.Generic; 
using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 
using Microsoft.AspNetCore.Hosting; 
using Microsoft.AspNetCore.Http; 


using Microsoft.Extensions.DependencyInjection; 
using SportsStore.Models; 

using Microsoft.Extensions.Configuration; 

using Microsoft.EntityFrameworkCore; 


namespace SportsStore { 
public class Startup { 


public Startup(IConfiguration configuration) => 
Configuration = configuration; 


public IConfiguration Configuration { get; } 


public void ConfigureServices(IServiceCollectio 
n services) { 
services .AddDbContext<ApplicationDbContext> 
(options => 
options.UseSqlServer ( 
Configuration|[ "Data:SportStoreProdu 
cts:ConnectionString"])); 
services.AddTransient<IProductRepository, E 
FProductRepository>() ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes .MapRoute( 
name: "pagination", 
template: "Products/Page{productPag 
e}", 


defaults: new { Controller = "Produ 
ct", action = "List" }); 


routes .MapRoute( 
name: "default", 
template: "{controller=Product}/{ac 
tion=List}/{id?}"); 


SeedData.EnsurePopulated(app) ; 








重要 的 是 ， 必 须 将 这 个 路 由 添加 到 方法 中 己 有 
的 默认 路 由 之 前 。 如 第 15 音 所 述 ， 路 由 系统 按照 列 
出 的 顺序 处 理 路 由 ， 新 路 由 需要 优 和 匈 于 现 有 路 由 。 





这 就 是 更 改 产 品 分 页 的 URL 方 案 所 需 的 唯一 更 
改 。MVC 和 路 由 功能 是 内 密 集成 的 ， 因 此 应 用 程序 
会 自动 反映 所 使 用 URL 中 的 更 改 ， 包 括 由 标签 助手 
生成 的 URL， 以 及 用 于 生成 页 面 导航 链接 的 URL。 
如 条 现 在 理解 不 了 路 由 ， 不 要 担心 ， 第 15 草 和 第 16 
章 将 详细 解释 路 由 。 











如 果 运 行 应 用 程序 并 单 击 分 页 链接 ， 你 将 看 到 
新 的 URL 结 构 ， 如 图 8-10 所 示 。 





Flat-packed 35,000-seat stadium 











图 8-10 ”浏览 器 中 显示 的 新 的 URL 结 构 


8.6 ”更 改 内 容 样 式 


我 们 已 经 创建 了 大 量 的 底层 代码 ， 并 且 开 始 集 
成 应 用 程序 的 基本 功能 ， 但 是 我 们 没有 在 外 观 上 花 
费 太 多 精力 。SportsStore 应 用 程序 的 设计 如 此 粳 
糙 ， 即 使 本 书 不 是 关于 设计 或 CSS 的 ， 也 会 影响 专 
业 性 。 本 节 将 修正 这 些 问 题 ， 实 现 带 有 一 个 header 
的 经 典 两 列 布局 ， 如 图 8-11 所 示 。 


Sports Store (header) 


Home è Product 1 
e Watersports e Product 2 
è Soccer °.. 

è Chess (main body) 


图 8-11 ”SportsStore 应 用 程序 的 设计 目标 
8.6.1 ”安装 Bootstrap 包 


下 面 使 用 Bootstrap 包 来 提供 将 要 应 用 于 应 用 程 
序 的 CSS 样 式 。 因 为 需要 依赖 Visual Studio 对 Bower 
的 文 持 来 安装 Bootstrap 包 ， 所 以 在 Add New Item 对 
话 框 的 General 类 别 中 选择 Bower Configuration File 
模板 ， 在 SportsStore 项 目 中 创建 名 为 bower.json 的 文 
件 ， 如 第 6 章 所 示 。 然 后 将 Bootstrap 包 添加 到 创建 
的 bower.json 文 件 的 dependencies 部 分 ， 如 代码 清单 
8-31 所 示 。 束 像 之 前 所 说 的 那样 ， 在 本 书 中 为 此 例 
EHME íT HI Bootstrap- 


代码 清单 8-31 ”将 Bootstrap 添 加 到 SportsStore 项 目的 bower.json 


KP 


"name": "asp.net", 
"private": true, 


"dependencies": { 
"bootstrap": "4.0.0-alpha.6" 
} 


} 





当 保 存 对 bower.json 文 件 所 做 的 更 改 时 ，Visual 
Studio 使 用 Bower 将 Bootstrap 软 件 包 下 载 到 
wwwroot/lib/ bootstrap 文 件 夹 中 。Bootstrap 依 赖 于 
jQuery 包 ， 上 所 以 jQuery 也 将 目 动 添加 到 项 目 中 。 


8.6.2 ”将 Bootstrap 样 式 应 用 于 布局 





第 5 章 解 释 了 Razor 布 局 如 何 工作 ， 如 何 使 用 它 
们 以 及 它们 如 何 组 成 布局 。 本 章 开 头 添加 的 视图 局 
动 文件 指定 使 用 名 为 _Layout.cshtml 的 文件 作为 默认 
布局 ， 这 就 是 应 用 初始 Bootstrap 样 式 的 地 方 ， 如 代 
码 清单 8-32 所 示 。 

















代码 清单 8-32 Bootstrap CSS 应 用 于 Views/Shared 文 件 夹 下 
的 _Layout.cshtml 文 件 


<!DOCTYPE 


<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<link rel="stylesheet" 
asp-href-include="/1ib/bootstrap/dist/**/*.mi 


n.css" 
asp-href-exclude="**/*-reboot*, **/*-grid*" /> 
<title>SportsStore</title> 
</head> 
<body> 
<div class="navbar navbar-inverse bg-inverse" role= 
"navigation" > 
<a class="navbar-brand" href="#">SPORTS STORE</ 
a> 
</div> 
<div class="row m-1 p-1"> 
<div id="categories" class="col-3"> 
Put something useful here later 
</div> 
<div class="col-9"> 
@RenderBody() 
</div> 
</div> 
</body> 
</html> 





上 述 代 码 中 的 link 元 素 包 仿 asp-href-include 和 和 
asp-href-exclude 属 性 ， 展 示 了 一 个 内 置 标签 助手 类 
的 例子 。 在 这 种 情况 下 ， 标 俭 助手 将 得 看 属性 的 
值 ， 并 生成 与 指定 路 径 匹 配 的 所 有 文件 的 link 元 
系 ， 其 中 可 包含 通配符 。 这 个 功能 很 有 用 ， 能 够 确 
保 可 以 在 不 破坏 应 用 程序 的 情况 下 添加 和 删除 
wwwroot 文 件 夹 结构 中 的 文件 ， 但 是 正如 第 25 章 解 
释 的 那样 ， 需 要 注意 确保 指定 的 路 径 仅 选 择期 望 的 
文件 。 














Bootstrap CSS 样 式 表 添加 到 布局 意味 着 可 以 
在 依赖 于 布局 的 任何 视图 中 使 用 它 定 义 样式 。 在 代 
码 清单 8-33 中 ， 可 以 看 到 应 用 于 List.cshtml 文 件 的 
样式 。 
代码 清单 8-33 ”Views/Product 文 件 夹 下 的 List.cshtml 文 件 中 的 
样式 内 容 


@model ProductsListViewModel 


@foreach (var p in Model.Products) { 
<div class="card card-outline-primary m-1 p-1"> 
<div class="bg-faded p-1"> 
<h4> 

@p . Name 

<span class="badge badge-pill badge-pri 
mary" style="float:right"> 

<small>@p.Price.ToString("c")</smal 


1> 
</span> 
</h4> 
</div> 
<div class="card-text p-1">@p.Description</div> 
</div> 
} 


<div page-model="@Model.PagingInfo" page-action="List" 
page-classes-enabled="true" 
page-class="btn" page-class-normal="btn-secondary" 
page-class-selected="btn-primary" class="btn-group 
pull-right m-1"> 
</div> 








需要 为 PageLinkTagHelper 类 生成 的 按钮 设置 样 
式 ， 但 是 这 里 不 会 将 Bootstrap 样 式 硬 编码 到 C# 代 码 
中 ， 因 为 当 在 应 用 程序 的 其 他 位 置 重用 标签 助手 或 
更 改 按钮 的 外 观 时 ， 这 样 会 更 加 困难 。 相 反 ， 这 里 
己 经 在 div 元 素 上 定义 了 上 自 定义 属性 ， 指 定 了 需要 的 























样式 ， 它 们 对 应 添加 到 标签 助手 类 中 的 属性 ， 然 后 
对 生成 的 a 元 素 设置 样式 ， 如 代码 清单 8-34 所 示 。 








代码 清单 8-34 将 样式 添加 到 PageLinkTagHelper.cs 文 件 中 生成 
的 元 素 上 





using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.Rendering; 
using Microsoft.AspNetCore.Mvc.Routing; 
using Microsoft.AspNetCore.Mvc.ViewFeatures; 
using Microsoft.AspNetCore. Razor. TagHelpers; 
using SportsStore.Models.ViewModels ; 


namespace SportsStore.Infrastructure { 


[HtmlTargetElement("div", Attributes = "page-model" 
)] 
public class PageLinkTagHelper : TagHelper { 
private IUrlHelperFactory urlHelperFactory; 


public PageLinkTagHelper(IUrlHelperFactory help 
erFactory) { 
urlHelperFactory = helperFactory; 


} 

[ViewContext | 

[HtmlAttributeNotBound | 

public ViewContext ViewContext { get; set; } 


public PagingInfo PageModel { get; set; } 


public string PageAction { get; set; } 


public bool PageClassesEnabled { get; set; } = 
false; 
public string PageClass { get; set; } 
public string PageClassNormal { get; set; } 
public string PageClassSelected { get; set; } 
public override void Process(TagHelperContext c 
ontext, 
TagHelperOutput output) { 
IUrlHelper urlHelper = urlHelperFactory.Get 
UrlHelper(ViewContext) ; 
TagBuilder result = new TagBuilder("div"); 
for (int i = 1; i <= PageModel.TotalPages; 


i++) { 
TagBuilder tag = new TagBuilder("a"); 
tag.Attributes["href"] = urlHelper.Acti 
on(PageAction, 
new { productPage = i }); 
if (PageClassesEnabled) { 
tag.AddCssClass(PageClass) ; 
tag.AddCssClass(i == PageModel.Curr 
entPage 
? PageClassSelected : PageClass 
Normal) ; 


} 
tag.InnerHtml.Append(i.ToString()); 


result.InnerHtml.AppendHtml (tag) ; 


} 
output.Content.AppendHtml(result.InnerHtm1 ) 





这 些 属性 的 值 将 自动 用 于 设置 标签 助手 的 属性 
值 ， 并 考虑 HTML 属性 名 称 格式 (page-class- 
normal) 和 C# 属 性 名 称 格式 (PageClassNormal) 之 
间 的 映射 。 这 人 允许 标签 助手 根据 HIML 元 素 的 属性 
进行 不 同 的 啊 应 ， 从 而 创建 一 种 更 灵活 的 方法 在 
MVC 应 用 程序 中 生成 内 容 。 


如 果 运 行 应 用 程序 ， 你 将 看 到 应 用 程序 的 外 观 
己 经 得 到 一 些 改进 ， 如 图 8-12 上 所 示 。 


[D SportsStore X 
€ Cc © localhost: 1000/Products/P xt : 
SPORTS STORE 
Put something (zz CT 
useful here later Bling-Bling King 
| Gold-plated, diamond-studded King 
: 





图 8-12 外观 得 到 改进 的 SportsStore 应 用 程序 


8.6.3 ”创建 分 部 视图 


作为 本 草 的 结尾 ， 下 面 重 构 应 用 程序 以 简化 


List.cshtml 视 图 文件 。 创 建 一 个 分 部 视图 (partial 
view) ， 它 是 一 个 内 容 厂 段 ， 可 以 藤 入 为 一 个 视 
图 ， 有 点 类 似 于 模板 。 第 21 章 将 详细 描述 分 部 视 
图 ， 并 且 当 你 需要 在 应 用 程序 的 不 同位 置 显 示 相 同 
的 内 容 时 ， 它 们 有 助 于 减少 重复 。 可 以 在 分 部 视图 
中 定义 一 次 ， 而 不 是 将 相同 的 Razor 标 记 复 制 并 粘 
贴 到 多 个 视图 中 。 为 了 创建 分 部 视图 ， 在 
Views/Shared 文 件 夹 添加 名 为 
ProductSummary.cshtml 的 Razor 视 图 文件 ， 并 添加 
代码 清单 8-35 所 示 的 代码 。 











代码 清单 8-35 ”Views/Shared 文 件 夹 下 的 
ProductSummary.cshtml 文 件 中 的 内 容 








@model Product 


<div class="card card-outline-primary m-1 p-1"> 
<div class="bg-faded p-1"> 
<h4> 
@Model .Name 
<span class="badge badge-pill badge-primary 
" style="float:right"> 
<small>@Model.Price.ToString("c")</smal 


l> 


</span> 
</h4> 
</div> 


<div class="card-text p-1">@Model.Description</div> 
</div> 








现在 需要 更 新 Views/Products 文 件 夹 中 的 
List.cshtml 文 件 ， 以 便 使 用 分 部 视图 ， 如 代码 清单 
8-36 所 示 。 


代码 清单 8-36 ”在 List.cshtml 文 件 中 使 用 分 部 视图 





@model ProductsListViewModel 


@foreach (var p in Model.Products) { 
@Html.Partial("ProductSummary", p) 
} 


<div page-model="@Model.PagingInfo" page-action="List" 
page-classes-enabled="true" 
page-class="btn" page-class-normal="btn-secondary" 
page-class-selected="btn-primary" class="btn-group 
pull-right m-1"> 
</div> 








这 里 已 经 将 List.cshtml 文 件 中 的 foreach 循 环 中 
的 标记 移动 到 新 的 分 部 视图 。 使 用 Html.Partial 辅 助 


方法 调用 分 部 视图 ， 其 中 包含 视图 名 称 和 视图 模型 
对 象 的 参数 。 切 换 到 这 样 的 分 部 视图 是 比较 好 的 做 
法 ， 从 而 允许 将 相同 的 标记 插入 需要 显示 产品 摘要 
的 任何 视图 中 。 如 图 8-13 所 示 ， 添 加 分 部 视图 不 会 
改变 应 用 程序 的 外 观 ; 只 是 改变 了 Razor 搜 索 生 成 
内 容 的 位 置 ， 从 而 生成 友 送 到 浏览 占 的 啊 应 。 

















k sStore x 
所 CŒ |© localhost60000/Produ ge wl): 
SPORTS STORE 
Put something [ 
Edi heeki | Kayak 
| A boat for one person 
| Lifejacket 
| protective and fashionable 
As ar ae Pane ae ae 


图 8-13 ”应 用 分 部 视图 
8.7 ”小结 


本 章 为 SportsStore 应 用 程序 构建 了 核心 基础 架 
构 。 现 在 还 没有 很 多 功能 可 供 你 同 客 户 展示 ， 但 我 
们 已 经 开始 了 领域 模型 开发 ， 其 产品 存储 库 由 SQL 


Server 和 Entity Framework Core 支 持 。 男 一 个 控制 器 
ProductController 可 以 生成 分 页 的 产品 列表 。 我 们 还 
创建 了 一 种 徐 洁 、 友 好 的 URL 结 构 。 





现在 压 层 的 基础 设施 代码 已 经 到 位 ， 我 们 可 以 
继续 增加 面 癌 客户 的 所 有 功能 一 一 按 类 别 导航 、 购 
物 车 以 及 结账 。 





第 9 章 ”SportsStore 的 导航 


本 章 将 继续 构建 SportsStore 应 用 程序 ， 添 加 对 
应 用 程序 导航 的 文 持 并 开始 构建 购物 车 。 








9.1 ASIN SME 


如 果 客 户 可 以 按 类 别 浏览 产品 ，SportsStoreY 
用 程序 将 更 为 方便 ， 这 可 分 3 个 阶段 完成 


。 增 强 ProductController 类 中 的 List 操 作 模 型 ， 以 便 
能 够 过 滤 存 储 库 中 的 Product 对 象 。 

。 重 构 并 增强 URL 结 构 。 

。 创建 类 别 列表 ， 展 示 在 站 点 的 边栏 中 ， 突 出 显 
示 当 前 类 别 并 链接 到 其 他 类 别 。 


9.1.1 ”过滤 产品 列表 


为 了 改进 视图 模型 类 (上 一 章 添 加 到 
SportsStore 项 目 中 的 ProductsListViewModel) , Fi 
要 让 当前 类 别 与 视图 进行 通信 ， 以 便 泻 染 边 柱 ， 这 
是 一 个 很 好 的 起 点 。 代 码 清 单 9-1 显 示 了 对 
Models/ViewModels 文 件 夹 中 的 
ProductsListViewModel.cs 文 件 所 做 的 更 改 。 


代码 清单 9-1 在 Models/ViewModels 文 件 夹 下 的 
ProductsListViewModel.cs 文 件 中 添加 一 个 属性 


using System.Collections.Generic; 
using SportsStore.Models; 


namespace SportsStore.Models.ViewModels { 


public class ProductsListViewModel { 


public IEnumerable<Product> Products { get; set 


> } 
public PagingInfo PagingInfo { get; set; } 
public string CurrentCategory { get; set; } 





这 里 添加 了 一 个 名 为 CurrentCategory 的 属性 。 


下 一 步 是 更 新 Product 控 制 器 ， 以 便 List 操 作 方 法 投 
关 别 过 滤 Product 对 象 ， 并 使 用 添加 到 视图 模型 中 的 
新 属性 来 指示 哪个 类 别 被 选中 。 代 码 清单 9-2 旺 示 
了 所 做 的 更 改 。 


代码 清单 9-2 ”在 Controllers 文 件 夹 下 的 ProductController.cs 文 件 
的 List 操 作 方 法 中 添加 对 类 别 的 支持 











using Microsoft.AspNetCore.Mvc; 
using SportsStore.Models; 

using System.Ling; 

using SportsStore.Models.ViewModels ; 


namespace SportsStore.Controllers { 


public class ProductController : Controller { 
private IProductRepository repository; 
public int PageSize = 4; 


public ProductController(IProductRepository rep 
o) { 
repository = repo; 


} 


public ViewResult List(string category, int pro 
ductPage = 1) 
=> View(new ProductsListViewModel { 
Products = repository .Products 
.Where(p => category == null || p.c 


ategory == category) 
.OrderBy(p => p.ProductID) 
.Skip((productPage - 1) * PageSize) 
. Take(PageSize), 
PagingInfo = new PagingInfo { 
CurrentPage = productPage, 
ItemsPerPage = PageSize, 
TotalItems = repository.Products.Co 
unt() 


J> 


CurrentCategory = category 





这 里 对 这 个 操作 方 活 做 了 3 处 更 改 。 首 先 ， 添 
加 一 个 名 为 category 的 参数 ，category 参 数 由 列表 中 
的 第 二 处 更 改 使 用 ， 这 是 LINQ 碍 询 的 增强 功能 
MREMAANZ, IBA 仅 选 择 匹 配 Category 属 性 性 的 
Product 对 象 。 最 后 一 处 更 改 是 设置 谎 加 到 
ProductsListViewModel 类 的 CurrentCategory 属 性 的 
值 。 但 是 ， 这 些 更 改 童 味 着 没有 正确 计 算 
PagingInfo.TotalItems 的 值 ， 因 为 没有 考虑 类 别 过 滤 
医 ， 稍 后 再 解决 这 个 问题 。 








单元 测试 


这 里 更 改 了 List 操 作 方 法 的 签名 ， 这 





更 新 已 存在 的 单元 测试 


秆 影响 编 


译 一 些 现 有 的 单元 测试 方法 。 为 了 解决 这 个 问题 ， 
需要 将 null 作 为 第 一 个 参数 传递 给 使 用 控制 邦 的 单 
元 测试 中 的 List 方 法 。 例 如 ， 在 
ProductControllerTests.cs X4} HJ Can_Paginateill iz\ 
中 ， 单 元 测试 的 操作 部 分 如 下 : 





[Fact] 
public void Can Paginate() { 
// Arrange 
Mock<IProductRepository> mock = new Mock<IProductRe 
pository>(); 
mock.Setup(m => m.Products).Returns((new Product[ [ ] 


{ 


new 
new 


}) .AsQueryable<Product>()); 


Product {ProductID 
Product {ProductID 
Product {ProductID 
Product {ProductID 
Product {ProductID 


wm BWHN 


1, 


Name 
Name 
Name 
Name 
Name 


ProductController controller = new ProductControlle 
r(mock.Object) ; 
controller.PageSize = 3; 


// Act 
ProductsListViewModel result = 
controller.List(null, 2).ViewData.Model as Prod 
uctsListViewModel; 


// Assert 

Product[ ] prodArray = result.Products.ToArray(); 
Assert.True(prodArray.Length == 2); 
Assert.Equal("P4", prodArray[0].Name) ; 
Assert.Equal("P5", prodArray[1].Name) ; 





iw xX} category 28 Anull, Wee ts EIFE Hil as 





从 存储 库 中 获取 的 所 有 Product 对 象 ， 这 与 琴 加 新 参 
数 之 前 的 情况 相同 。 此 外 ， 还 需要 对 
Can_Send_Pagination_View_Model 测 试 做 同样 的 修 
Be 





[Fact] 
public void Can_Send_Pagination_ View _Model() { 

// Arrange 

Mock<IProductRepository> mock = new Mock<IProductRe 
pository>(); 


mock.Setup(m => m.Products).Returns((new Product[ ] 


{ 

new Product {ProductID = 1, Name = "P1"}, 
new Product {ProductID = 2, Name = "P2"}, 
new Product {ProductID = 3, Name = "P3"}, 
new Product {ProductID = 4, Name = "P4"}, 
new Product {ProductID = 5, Name = "P5"} 

}) .AsQueryable<Product>()); 

// Arrange 

ProductController controller = 
new ProductController(mock.Object) { PageSize = 

3 }; 


// Act 
ProductsListViewModel result = 
controller.List(null, 2).ViewData.Model as Prod 
uctsListViewModel; 


// Assert 

PagingInfo pageInfo = result.PagingInfo; 
Assert.Equal(2, pageInfo.CurrentPage) ; 
Assert.Equal(3, pageInfo.ItemsPerPage) ; 
Assert.Equal(5, pageInfo.Totalitems) ; 
Assert.Equal(2, pageInfo.TotalPages) ; 





HEA MRA, BE a TRS ER 


速 同 步 成 为 第 二 条 重要 的 原则 。 





要 答 看 类 别 过 滤 的 效 末 ， 请 局 动 应 用 程序 并 使 
用 以 下 得 询 字符 串 选 择 一 个 类别 ， 将 闯 口 更 改 为 
Visual Studio 为 项 目 分 配 的 端口 〈 注 意 ，Soccer 的 首 
字母 要 大 写 ) : 


http://localhost :60000/?category=Soccer 


你 将 只 能 看 到 足球 类 别 中 的 商品 ， 如 图 9-1 所 





人 小。 


A 











< CS | © localhost:60000/?category=Socce w : 
SPORTS STORE 
Put somet hing 
useful here later Soccer Ball eÐ 
FIFA-approved size and weight 
Corner Flags 


Give your playing field a professional touch 








Stadium 








Flat-packed 35,000-seat stadium 


BE 





图 9-1 ”使 用 查询 字符 串 按 类别 过 滤 商 品 


显然 ， 用 户 不 会 使 用 URL 导 航 到 类 别 ， 但 是 一 


旦 基础 设施 代码 a 到位， 束 可 以 看 到 MVC 应 用 程序 中 
一 个 小 的 更 改 也 可 以 产生 很 大 的 影响。 


单元 测试 





类 别 过 渡 


你 需要 使 用 单元 测试 来 测试 类 别 过 滤 功 能 ， 以 
确保 过 滤器 能 够 正确 地 生成 指定 类 别 的 了 商品。 下 面 
是 添加 到 ProductControllerTests 类 的 测试 方法 : 


N 


g 








[Fact] 
public void Can Filter Products() { 


// Arrange 

// - create the mock repository 

Mock<IProductRepository> mock = new Mock<IProductRe 
pository>(); 

mock.Setup(m => m.Products).Returns((new Product[ ] 


{ 

new Product {ProductID = 1, Name = "P1", Catego 
ry = "Cat1"}, 

new Product {ProductID = 2, Name = "P2", Catego 
ry = "Cat2"}, 

new Product {ProductID = 3, Name = "P3", Catego 
ry = "Cat1"}, 


new Product {ProductID = 4, Name = "P4", Catego 
ry = "Cat2"}, 
new Product {ProductID = 5, Name = "P5", Catego 
ry = "Cat3"} 
}) .ASQueryable<Product>()); 


// Arrange - create a controller and make the page 
size 3 items 

ProductController controller = new ProductControlle 
r(mock.Object) ; 

controller.PageSize = 3; 


// Action 
Product[] result = 
(controller.List("Cat2", 1).ViewData.Model as P 
roductsListViewModel ) 
.Products.ToArray(); 


// Assert 

Assert.Equal(2, result.Length) ; 

Assert. True(result[@].Name == "P2" && result[@].Cat 
egory == "Cat2"); 

Assert.True(result[1].Name == "P4" && result[1].Cat 
egory == "Cat2"); 


} 





以 上 测试 将 创建 一 个 模拟 的 存储 库 ， 其 中 包含 
属于 多 个 类 别 的 Product 对 象 。 使 用 一 个 操作 方法 请 
求 菏 个 特定 类 别 ， 并 检查 结果 以 确保 结果 是 正确 的 
对 象 并 具有 正确 的 顺序 。 








9.1.2 ”优化 URL 结 构 





没 人 想 看 到 或 使 用 丑陋 的 网 址 ， 如 /?category = 
Soccer。 为 了 解决 这 个 问题 ， 可 在 Startup 类 的 
Configure 方 法 中 更 改 路 由 配置 ， 以 创建 一 组 更 友好 
的 URL， 如 代码 清单 9-3 所 示 。 





代码 清单 9-3 ”更 改 SportsStore 文 件 夹 下 的 Startup.cs 文 件 中 的 路 
由 方案 





public void Configure(IApplicationBuilder app, IHosting 
Environment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages() ; 
app.UseStaticFiles(); 
app.UseMvc(routes => { 


routes .MapRoute( 
name: null, 
template: "{category}/Page{productPage: int} 
3 
defaults: new { controller = "Product", act 
ion = "List" } 


); 


routes .MapRoute( 
name: null, 
template: "Page{productPage:int}", 
defaults: new { controller = "Product", 
action = "List", productPage = 1 } 


) ; 
routes .MapRoute( 
name: null, 
template: "{category}", 
defaults: new { controller = "Product", 
action = "List", productPage = 1 } 
); 
routes .MapRoute( 
name: null, 
template: "", 
defaults: new { controller = "Product", act 
ion = "List", 


productPage = 1 }); 


routes.MapRoute(name: null, template: "{control 
ler}/{action}/{id?}"); 
}); 
SeedData.EnsurePopulated(app) ; 





ng 


Pa 
[| 


按照 代码 清单 9-3 中 的 顺序 添加 新 路 由 非 帝 重 
要 。 路 由 按 定 义 的 顺序 生效 ， 如 果 更 改 顺 序 ， 你 会 
得 到 一 些 奇 怪 的 结果 。 


这 些 路 由 表示 的 URL 结 构 如 表 9-1 所 示 。 第 15 
章 和 第 16 章 将 详细 解释 路 由 系统 。 


表 9-1 路 由 摘要 


列 出 所 有 类 别 商品 的 第 一 页 


列 出 特定 页 面 《在 本 例 中 为 第 2 页 ) ， 显 示 所 有 类 别 的 商品 




















显示 来 自 特定 类 别 的 商品 的 第 一 页 (在 本 例 中 为 Soccer 类 别 》 





显示 指定 类 别 《 在 这 种 情况 下 为 Soccer) 的 商品 的 指定 页 面 〈 在 本 例 中 为 第 


/Soccer/Page2 
2 页 ) 





MVC 使 用 ASP.NET Core 路 由 系统 来 处 理 来 自 
客户 端的 传 和 请求， 并且 生成 符合 URL 结 构 的 可 垦 
入 网 页 中 的 传 出 URL。 通 过 使 用 路 由 系统 来 处 理 传 
入 请 求 和 传 出 URL， 可 以 确保 应 用 程序 中 的 所 有 
URL 一 致 。 





IUrlHelper 接 口 提供 对 URL 生 成 功能 的 访问 。 
你 在 上 一 章 中 创建 的 标签 助手 使 用 了 这 个 接口 ， 以 
及 其 中 定义 的 操作 方法 。 现 在 我 们 想 开 始 生 成 更 复 
茶 的 URL， 我 们 需要 一 种 从 视图 中 接收 附加 信息 的 
方法 ， 而 不 必 为 标签 助手 类 添加 额外 的 属性 。 邓 运 
的 是 ， 标 签 助手 有 一 个 很 好 的 功能 ， 人 允许 属性 拥有 
公共 前 级 ， 从 而 可 以 在 单个 集合 中 接收 ， 如 代码 清 
单 9-4 所 示 。 











代码 清单 9-4 在 mnfrastructure 文 件 夹 下 的 PageLinkTagHelper.cs 
文件 中 接收 前 级 属性 值 


using Microsoft.AspNetCore.Mvc; 


using Microsoft.AspNetCore.Mvc.Rendering; 
using Microsoft.AspNetCore.Mvc.Routing; 
using Microsoft.AspNetCore.Mvc.ViewFeatures; 
using Microsoft.AspNetCore.Razor.TagHelpers; 
using SportsStore.Models.ViewModels ; 

using System.Collections.Generic; 


namespace SportsStore.Infrastructure { 


[HtmlTargetElement("div", Attributes = "page-model" 
)] 
public class PageLinkTagHelper : TagHelper { 
private IUrlHelperFactory urlHelperFactory; 


public PageLinkTagHelper(IUrlHelperFactory help 
erFactory) { 
urlHelperFactory = helperFactory; 


} 


[ViewContext] 
[HtmlAttributeNotBound] 
public ViewContext ViewContext { get; set; } 


public PagingInfo PageModel { get; set; } 
public string PageAction { get; set; } 


[HtmlAttributeName(DictionaryAttributePrefix = 
"page-url-")] 
public Dictionary<string, object> PageUrlValues 
{ get; set; } 
= new Dictionary<string, object>(); 


public bool PageClassesEnabled { get; set; } = 
false; 
public string PageClass { get; set; } 


public string PageClassNormal { get; set; } 
public string PageClassSelected { get; set; } 


public override void Process(TagHelperContext c 
ontext, 
TagHelperOutput output) { 
IUrlHelper urlHelper = urlHelperFactory.Get 
UrlHelper(ViewContext) ; 
TagBuilder result = new TagBuilder("div"); 
for (int i = 1; i <= PageModel.TotalPages; 
i++) { 
TagBuilder tag = new TagBuilder("a"); 
PageUrlValues["productPage"] = i; 
tag.Attributes["href"] = urlHelper.Acti 
on(PageAction, PageUrlValues) ; 
if (PageClassesEnabled) { 
tag.AddCssClass(PageClass) ; 
tag.AddCssClass(i == PageModel.Curr 
entPage 
? PageClassSelected : PageClass 
Normal) ; 
} 
tag.InnerHtml.Append(i.ToString()); 
result. InnerHtml.AppendHtml (tag) ; 


} 
output. Content .AppendHtml (result. InnerHtm1 ) 





通过 使 用 HtmlAttributeName 特 性 (attribute) 
装饰 一 个 标签 助手 属性 (property) ， 可 以 为 元 素 


上 的 属性 名 称 指定 前 级 ， 在 这 个 例子 中 是 page- 
url-。 名 称 以 此 前 组 开头 的 任何 属性 的 值 都 将 被 还 
加 到 分 配给 PageUrlValues 属 性 的 字典 中 ， 然 后 传递 
给 IUrlHelper.Action 方 法 ， 以 生成 由 标签 助手 输出 
的 a 元 素 的 href 属 性 。 








在 代码 清单 9-5 中 ， 已 经 为 标签 助手 处 理 的 div 
元 素 添 加 了 一 个 新 的 属性 ， 指 定 了 用 于 生成 URL 的 
类 别 。 昌 然 只 为 视图 添加 了 一 个 新 的 属性 ， 但 是 具 
有 相同 前 组 的 任何 属性 都 将 被 添加 到 字典 中 。 


代码 清单 9-5 ”在 Views/Home 文 件 夹 下 的 List.cshtml 文 件 中 添加 
新 属性 





@model ProductsListViewModel 


@foreach (var p in Model.Products) { 
@Html.Partial("ProductSummary", p) 
} 


<div page-model="@Model.PagingInfo" page-action="List" 
page-classes-enabled="true" 
page-class="btn" page-class-normal="btn-secondary" 
page-class-selected="btn-primary" page-url-category 


="@Model.CurrentCategory" 
class="btn-group pull-right m-1"> 
</div> 








在 进行 上 述 更 改 之 前 ， 为 分 页 链接 生成 的 链接 
如 下 所 示 : 


http://<myserver>:<port>/Pagel 


如 采用 户 单 击 这 样 的 页 面 链 接 ， 类 别 过 滤器 将 
会 于 失 ， 应 用 程序 将 显示 一 个 包含 所 有 类 别 产 品 的 
页 面 。 通 过 添加 从 视图 模型 中 获取 的 当前 类 别 ， 底 
会 生成 下 面 这 样 的 URL: 


http://<myserver>:<port>/Chess/Page1 


当 用 户 单 击 此 类 链接 时 ， 当 前 类 别 将 被 传递 给 
List 操 作 方 法 ， 并 且 会 保留 过 小 功能 。 进 行 此 更 改 
后 ， 可 以 访问 /Chess 或 /Soccer 等 网 址 ， 你 会 看 到 页 
面 底部 的 页 面 链接 已 正确 包含 该 类 别 。 











9.1.3 PIER A SMI E 


你 需要 为 客户 近 供 一 种 方式 ， 无 须 用 户 在 URL 
中 输入 类 别 。 这 意味 看 需要 癌 他 们 呈现 可 用 类 列 的 
列表 ， 并 指出 当前 选择 了 哪个 关 别 《如 条 有 的 
话 ) 。 当 构建 应 用 程序 时 ， 将 在 多 个 控制 磺 中 使 用 
这 个 类 别 列表 ， 所 以 需要 一 些 自 包 含 且 可 重用 的 东 
西 。 

















ASP.NET Core MVC 具 有 视图 组 件 的 概念 ， 这 
对 于 创建 诸如 可 重复 使 用 的 导航 控件 之 类 的 项 目 是 
非常 合适 的 。 视 图 组 件 是 C# 类 ， 可 以 提供 少量 可 重 
用 的 应 用 程序 逻辑 ， 能 够 选择 和 显示 Razor 分 部 视 
图 。 第 22 章 将 详细 描述 视图 组 件 。 














在 本 市 的 例子 中 ， 将 创建 一 个 视图 组 件 ， 通 过 
从 共 至 布局 调用 组 件 来 呈现 导 般 炉 蛙 ， 并 将 其 集成 
到 应 用 程序 中 。 这 种 方法 让 我 们 能 够 使 用 一 个 常规 





的 C# 类 ， 可 以 包含 我 们 所 需要 的 任何 应 用 程序 好 
各 ， 并 且 可 以 像 任何 其 他 类 一 样 进行 蛙 元 测试 。 这 
是 一 种 在 保留 整体 MVC 方 法 的 同时 创建 应 用 程序 的 
较 小 片段 的 好 方法 。 





1. 创建 导航 视图 组 件 


创建 名 为 Components 的 文件 夹 〈 一 般 用 来 存放 
视图 组 件 ) ， 并 在 其 中 添加 名 为 
NavigationMenuViewComponent.cs 的 类 ， 用 于 定义 
代码 清单 9-6 所 示 的 类 。 


代码 清单 9-6 Components XFX FHI 
NavigationMenuViewComponent.cs 文 件 的 内 容 





using Microsoft.AspNetCore.Mvc; 


namespace SportsStore.Components { 


public class NavigationMenuViewComponent : ViewComp 
onent { 


public string Invoke() { 


return "Hello from the Nav View Component"; 
} 
} 
} 








在 Razor 视 图 中 使 用 组 件 时 ， 将 调用 视图 组 件 
的 Invoke 方 法 ， 并 将 Invoke 方 法 的 结果 插入 HTML 
中 ， 发 送 到 浏览 器 。 我 们 已 经 开始 使 用 一 个 返回 字 
符 串 的 简单 视 儿 组件， 但 我 们 很 快 融会 用 动态 
HTMLW AGRE 
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们 将 在 共 至 布局 中 使 用 视图 组 件 ， 而 不 是 在 特定 视 
图 中 。 在 视图 中 ， 可 通过 @await 
Component.InvokeAsync 表 达 式 使 用 视图 组 件 ， 如 代 
人 码 清单 9-7 所 示 。 














代码 清单 9-7 在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 件 
中 使 用 视图 组 件 


<!DOCTYPE html> 


<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<link rel="stylesheet" 
asp-href-include="/lib/bootstrap/dist/**/*.mi 
n.css" 
asp-href-exclude="**/*-reboot*, **/*-grid*" /> 
<title>SportsStore</title> 
</head> 
<body> 
<div class="navbar navbar-inverse bg-inverse" role= 
"navigation" > 
<a class="navbar-brand" href="#">SPORTS STORE</ 
a> 
</div> 
<div class="row m-1 p-1"> 
<div id="categories" class="col-3"> 
@await Component. InvokeAsync("NavigationMen 


u") 
</div> 
<div class="col-9"> 

@RenderBody() 
</div> 
</div> 
</body> 
</html> 








这 里 删除 了 占 位 符 文 本 ， 并 将 其 蔡 换 为 对 
Component.InvokeAsync 方 法 的 调用 。 此 方法 的 参数 
是 组 件 类 的 名 称 ， 和 省 略 了 类 名 的 ViewComponent 部 


分 ， 因 此 NavigationMenu 指 定 了 
NavigationMenuViewComponent 类 。 如 果 运 行 该 应 
用 程序 ， 你 将 看 到 Invoke 方 法 的 输出 包含 在 发 送 给 
浏览 器 的 HTML 中 ， 如 图 9-2 所 示 。 
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图 9-2 ”使 用 视图 组 件 的 输出 
2. 生成 类 别 列 表 


现在 可 以 返回 导航 视 几 控制 句 并 生成 一 组 真实 
的 闫 别 。 可 以 使 用 编程 方式 为 类 别 构建 HIML， 驶 
像 为 页 面 标签 助手 所 做 的 那样 ， Been 
一 个 好 处 是 它们 可 以 演 染 Razor 分 部 视图 。 这 意味 
大 可 以 使 用 视图 组 件 生成 组 件 列 表 ， 然 后 使 用 更 具 

















表现 力 的 Razor 语 法 来 呈现 用 于 显示 它们 的 HTML 。 
第 一 步 是 更 新 视图 组 件 ， 如 代码 清 单 9-8 所 示 。 





代码 清单 9-8 ”在 Components 文 件 夹 下 的 
NavigationMenuViewComponent.cs 文 件 中 添加 类 别 





using Microsoft.AspNetCore.Mvc; 
using System.Ling; 
using SportsStore.Models; 


namespace SportsStore.Components { 
public class NavigationMenuViewComponent : ViewComp 


onent { 
private IProductRepository repository; 


public NavigationMenuViewComponent(IProductRepo 


sitory repo) { 
repository = repo; 


} 


public IViewComponentResult Invoke() { 
return View(repository.Products 
-Select(x => x.Category) 
.Distinct() 
-OrderBy(x => x)); 





代码 清单 9-8 中 的 构造 函数 定义 了 一 个 
IProductRepository 参 数 。 当 MVC 需 要 创建 视图 组 件 
类 的 实例 时 ， 它 将 需要 提供 这 个 参数 并 检查 Startup 
类 中 的 配置 以 确定 应 使 用 哪个 实现 对 象 。 这 与 第 8 
章 在 控制 右 中 使 用 的 依赖 注入 功能 相同 ， 并 且 具 有 
相同 的 效果 ， 即 允许 视图 组 件 在 不 知道 将 使 用 哪个 
存储 库 实现 的 情况 下 访问 数据 ， 如 第 18 章 所 述 。 








在 Invoke 方 法 中 ， 使 用 LINQ 对 存储 库 中 的 一 组 
类 别 进行 选择 和 排序 ， 并 将 它们 作为 参数 传递 给 
View 方 法 ，View 方 法 会 呈现 默认 的 Razor 分 部 视 
图 ， 使 用 IViewComponentResult 对 象 从 方法 返回 其 
详细 信息 ， 第 22 草 会 详细 朱 述 此 过 程 。 





单元 测试 一 一 生成 类 别 列表 





用 于 类 别 列表 的 单元 测试 相对 简 持 。 目 标 是 创 


o 字母 顺序 排列 的 列表 ， 并 且 不 包含 重复 

。 最 简单 的 方法 是 提供 一 些 具 有 重复 类 别 且 不 按 
EE a 其 传递 给 标签 助手 类 ， 并 
判断 数据 是 否 已 被 正确 清理 。 在 SportsStore.Tests 项 
目 中 ， 在 名 为 
NavigationMenuViewComponentTests.cs 的 类 文件 中 
定义 的 蛙 元 测试 如 下 : 











using System.Collections.Generic; 

using System.Ling; 

using Microsoft.AspNetCore.Mvc.ViewComponents ; 
using Mog; 

using SportsStore.Components ; 

using SportsStore.Models; 

using Xunit; 

namespace SportsStore.Tests { 


public class NavigationMenuViewComponentTests { 


[Fact ] 
public void Can_Select_Categories() { 
// Arrange 
Mock<IProductRepository> mock = new Mock<IP 
roductRepository>() ; 


mock.Setup(m => m.Products).Returns((new Pr 
oduct[] { 
new Product {ProductID = 1, Name = "P1" 


» Category = "Apples"}, 
new Product {ProductID = 2, Name = "P2" 


» Category = "Apples"}, 
new Product {ProductID = 3, Name = "P3" 
» Category = "Plums"}, 
new Product {ProductID = 4, Name = "P4" 
， Category = "Oranges"}, 
}) .AsQueryable<Product>()); 
NavigationMenuViewComponent target = 
new NavigationMenuViewComponent (mock. Ob 
ject); 


// Act = get the set of categories 
string[] results = ((IEnumerable<string>)(t 
arget.Invoke() 
as ViewViewComponentResult).ViewData.Mo 
del).ToArray(); 


// Assert 
Assert.True(Enumerable.SequenceEqual(new st 
ring[] { "Apples", 
"Oranges", "Plums" }, results)); 





以 上 代码 创建 了 一 个 模拟 的 存储 库 实 现 ， 其 中 
包含 重复 的 以 及 没有 正确 排序 的 闫 别 。 我 们 判断 重 
复 项 将 被 删除 ， 并 强制 按 字 母 顺 序 排 列 。 





3. 创建 视图 





Razor 使 用 不 同 的 约定 来 处 理 视 图 组 件 选择 的 
视图 。 视 图 的 默认 名 称 和 搜索 位 置 与 用 于 控制 器 的 
不 同 。 为 此 ， 创 建 
Views/Shared/Components/NavigationMenu X44% , 
并 在 其 中 添加 名 为 Default.cshtml 的 视图 文件 ， 内 容 
如 代码 清单 9-9 所 示 。 


代码 清单 9-9 Views/Shared/Components/NavigationMenu X 4# 
夹 下 的 Default.cshtml 文 件 的 内 容 





@model IEnumerable<string> 


<a class="btn btn-block btn-secondary" 
asp-action="List" 
asp-controller="Product" 
asp-route-category=""> 
Home 

</a> 

@foreach (string category in Model) { 
<a class="btn btn-block btn-secondary" 


asp-action="List" 
asp-controller="Product" 
asp-route-category="@category” 
asp-route-productPage="1"> 
@category 
</a> 





这 个 视图 使 用 第 24 章 和 第 25 章 描述 的 内 置 标签 
助手 之 一 来 创建 a 元 素 ， 其 href 属 性 包含 选择 不 同 产 
品类 列 的 URL。 


如 果 运 行 应 用 程序 ， 束 可 以 看 到 类 别 链接 ， 如 
图 9-3 所 示 。 如 宁 单 击 东 个 类 别 ， 吏 会 更 新 条 目 列 
表 ， 以 仅 显 示 所 选 关 别 中 的 条 目 。 











$ x 
= Œ | O Iocalhost6 ， Page1 wi: 
SPORTS STORE 
Home 





Soccer Ball = 


FIFA-approved size and weight 











SoU! | Corner Flags 34.9: 
maa ee ey 入 NEO arp ~ | 


图 9-3 ”使 用 视图 组 件 生成 类 别 链 接 


4. 突出 显示 当前 类 别 


现在 还 没有 给 用 户 发 出 反馈 以 指示 选择 了 哪个 
类 别 。 从 列表 中 的 条 目 推 师 出 类 别 也 是 可 能 的 ， 但 
是 提供 一 些 消 晰 的 视觉 反馈 似乎 更 好 。ASP.NET 
Core MVC 组 件 〈 如 控制 工 和 视图 组 件 ) 可 以 通过 
请 求 上 下 文 对 象 来 接收 有 关 当 前 请 求 的 信息 。 大 多 
数 情况 下 ， 可 以 依赖 用 于 创建 组 件 的 基 类 来 获取 上 
下 文 对 象 ， 例 如 在 使 用 Controller 基 类 创建 控制 器 
时 。 











ViewComponent 基 类 也 不 例外 ， 它 通过 一 组 属 
性 提供 对 上 下 文 对 象 的 访问 。 其 中 一 个 属性 名 为 
RouteData， 它 提供 有 关 路 由 系统 如 何 处 理 请 求 URL 
的 信息 。 


代码 清单 9-10 使 用 RouteData 属 性 来 访问 请 求 数 
据 ， 以 获取 当前 所 选 类 别 的 值 。 可 以 通过 创建 另 一 








个 视图 模型 类 将 类 别传 递 给 视图 (这 就 是 在 实际 项 
en 但 是 为 了 展示 更 多 方式 ， 我 们 
将 使 用 第 2 章 介 绍 的 view bag 功 能 。 











代码 清单 9-10 在 NavigationMenuViewComponent.cs 文 件 中 传 
8 ITA FR Fl 





using Microsoft.AspNetCore.Mvc; 
using System.Ling; 
using SportsStore.Models; 


namespace SportsStore.Components { 


public class NavigationMenuViewComponent : ViewComp 
onent { 
private IProductRepository repository; 


public NavigationMenuViewComponent (IProductRepo 
sitory repo) { 
repository = repo; 


} 


public IViewComponentResult Invoke() { 
ViewBag.SelectedCategory = RouteData?.Value 
s["category"]; 
return View(repository.Products 
.Select(x => x.Category) 
.Distinct() 
.OrderBy(x => x)); 


} 


在 Invoke 方 法 中 ， 已 经 为 ViewBag 对 象 动 态 分 
配 了 SelectedCategory 属 性 ， 并 将 属性 值 设 置 为 当前 
类 别 ， 当 前 类 别 是 通过 RouteData 属 性 返回 的 上 下 文 
对 象 获得 的 。 正 如 第 2 章 解 释 的 那样 ，ViewBag 和 是 动 
态 对 象 ， 可 以 简单 地 为 它们 分 配 值 来 定义 新 的 属 
TE o 


单元 测试 一 一 报告 所 选美 别 





可 以 通过 在 单元 测试 中 读 取 ViewBag 属 性 的 值 
来 测试 视图 组 件 是 否 正 确 添加 了 所 选 类 别 的 详细 信 
息 ， 该 值 可 通过 第 22 章 描述 的 
ViewViewComponentResult 类 获得 。 下 面 是 添加 到 





NavigationMenuViewComponentTests 类 中 的 单元 测 





[Fact] 
public void Indicates Selected Category() { 


// Arrange 

string categoryToSelect = "Apples"; 

Mock<IProductRepository> mock = new Mock<IProductRe 
pository>(); 

mock.Setup(m => m.Products).Returns((new Product[ ] 


{ 

new Product {ProductID = 1, Name = "P1", Catego 
ry = “Apples"}, 

new Product {ProductID = 4, Name = "P2", Catego 
ry = "Oranges"}, 


}) .AsQueryable<Product>()); 
NavigationMenuViewComponent target = 
new NavigationMenuViewComponent (mock .Object) ; 
target .ViewComponentContext = new ViewComponentCont 
ext { 
ViewContext = new ViewContext { 
RouteData = new RouteData() 
J 
}; 
target.RouteData.Values["category"|] = categoryToSel 
ect; 


// Action 
string result = (string) (target.Invoke() as 
ViewViewComponentResult) .ViewData["SelectedCate 


gory" ]; 


// Assert 


Assert.Equal(categoryToSelect, result); 
} 


以 上 单元 测试 通过 ViewComponentContext 属 性 
为 视图 组 件 提供 路 由 数据 ， 访 属性 指定 了 视图 组 件 
接收 所 有 上 下 文 数据 的 方式 。 
ViewComponentContext 属 性 通过 ViewContext 子 属 
性 提供 对 特定 于 视图 的 上 下 文 数据 的 访问 ， 而 后 通 
过 RouteData 子 属性 提供 对 路 由 信息 的 访问 。 单 元 测 
试 中 的 大 多 数 代码 用 于 创建 上 下 文 对 象 ， 这 些 对 象 
将 以 与 应 用 程序 运行 时 呈现 的 相同 方式 提供 所 选 类 
别 ， 其 上 下 文 数据 由 ASP.Net Core MVC 提 供 。 











现在 提供 了 有 天 选择 哪个 类 列 的 信息 ， 可 以 利 
用 这 一 点 更 新 视图 组 件 选 择 的 视图 ， 并 改变 用 于 设 
置 链接 样式 的 CSS 类 ， 使 代表 当前 类 别 的 CSS 类 与 
其 他 类 别 不 同 。 代 码 清单 9-11 显 示 了 对 


Default.cshtml 文 件 所 做 的 更 改 。 


代码 清单 9-11 7EViews/Shared/Components/NavigationMenu X 
件 夹 下 的 Default.cshtml 文 件 中 突出 显示 当前 类 别 


@model IEnumerable<string> 


<a class="btn btn-block btn-secondary" 
asp-action="List" 
asp-controller="Product" 
asp-route-category=""> 
Home 

</a> 


@foreach (string category in Model) { 


<a class="btn btn-block 

@(category == ViewBag.SelectedCategory ? "btn-pr 
imary": "btn-secondary")" 

asp-action="List" 
asp-controller="Product" 
asp-route-category="@category" 
asp-route-productPage="1"> 
@category 

</a> 





在 class 属 性 中 使 用 了 一 个 Razor 表 达 式 ， 从 而 
将 btn-primary 类 应 用 于 表示 所 选 类 别 的 元 际 ， 其 他 
类 别 的 元 素 使 用 的 是 btn-secondary 类 。 为 这 些 类 别 











应 用 不 同 的 Bootstrap 样 式 ， 并 使 活动 按钮 突出 显 
示 ， 如 网 9-4 所 示 。 
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图 9-4 ”突出 显示 所 选 类 别 
9.1.4 更 正 页 数 


需要 更 正 页 面 链接 ， 以 便 在 选择 类 列 时 它们 能 
够 正常 工作 。 目 前 ， 页 面 链接 的 数量 由 存储 库 中 的 
商品 尽数 人 确定， 而 不 是 由 所 选 类 别 中 的 商品 数量 确 
定 。 这 意味 看 客户 可 以 单 击 Chess 类 列 第 2 页 的 链 
接 ， 但 会 得 到 一 个 空 日 页面， 因为 没有 足够 的 
Chess 商 品 来 填充 两 个 页 面 ， 如 图 9-5 所 示 。 








口 Sportsstore x 


oe Œ | © locathost:60000/Chess/Page2 wr) : 
Home 1 3 


Soccer 


Watersports 














图 9-5 ”选择 类 别 时 显示 错误 的 页 面 链接 


可 以 通过 更 新 Product 控 制 器 中 的 List 操 作 方 法 
来 解决 这 个 问题 ， 让 分 页 信息 按 类 别 计 算 ， 如 代码 
清单 9-12 所 示 。 


it 


代码 清单 9-12 7EControllers C+ 3€ F AY ProductController.cs X 
件 中 创建 文 持 类 别 的 分 页 数据 





using Microsoft.AspNetCore.Mvc; 
using SportsStore.Models; 

using System. Linq; 

using SportsStore.Models.ViewModels; 


namespace SportsStore.Controllers { 


public class ProductController : Controller { 
private IProductRepository repository; 
public int PageSize = 4; 


public ProductController(IProductRepository rep 
o) { 
repository = repo; 


} 


public ViewResult List(string category, int pro 
ductPage = 1) 
=> View(new ProductsListViewModel { 
Products = repository .Products 
.Where(p => category == null || p.C 
ategory == category) 
.OrderBy(p => p.ProductID) 
.Skip((productPage - 1) * PageSize) 
.Take(PageSize), 
PagingInfo = new PagingInfo { 
CurrentPage = productPage, 
ItemsPerPage = PageSize, 
TotalItems = category == null ? 
repository .Products.Count() 


repository.Products.Where(e 
=> 
e.Category == category) 
.Count() 


J 


CurrentCategory = category 


}); 





如 果 已 选择 某 个 类 别 ， 束 返回 该 类 别 中 的 商品 
数量 ; 如 果 没 有 ， FL JEI Pay i Sk AL 现在 ， 当 查 看 








某 个 类 别 时 ， 页 面 底部 的 链接 正确 反映 了 该 类 别 中 
的 商品 数量 ， 如 图 9-6 所 示 。 
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图 9-6 ”显示 特定 类 别 页 数 


测试 特定 类 别 的 商品 计数 





为 不 同类 别 计算 当前 商品 数量 是 很 简单 的 。 创 
娃 一 个 模拟 的 存储 库 ， 其 中 包含 一 系列 类 别 中 的 已 
知 数据 ， 然 后 调用 List 操 作 方 法 依次 请 求 每 个 类 


别 。 以 下 是 添加 到 ProductControllerTests 类 中 的 单 
元 测试 方法 : 





[Fact] 
public void Generate Category Specific Product Count() 


{ 


// Arrange 

Mock<IProductRepository> mock = new Mock<IProductRe 
pository>(); 

mock.Setup(m => m.Products).Returns((new Product[ ] 


{ 

new Product {ProductID = 1, Name = "P1", Catego 
ry = "Cat1"}, 

new Product {ProductID = 2, Name = "P2", Catego 
ry = "Cat2"}, 

new Product {ProductID = 3, Name = "P3", Catego 
ry = "Cat1"}, 

new Product {ProductID = 4, Name = "P4", Catego 
ry = "Cat2"}, 

new Product {ProductID = 5, Name = "P5", Catego 
ry = "Cat3"} 


}) .AsQueryable<Product>()); 

ProductController target = new ProductController(mo 
ck.Object) ; 

target.PageSize = 3; 


Func<ViewResult, ProductsListViewModel> GetModel = 
result => 
result?.ViewData?.Model as ProductsListViewMode 
1; 


// Action 


int? resi = GetModel(target.List("Cat1"))?.PagingIn 


fo. Totalitems; 


int? res2 = GetModel(target.List("Cat2"))?.PagingIn 


fo.Totalitems; 


int? res3 = GetModel(target.List("Cat3"))?.PagingIn 


fo.Totalitems; 


int? resAll = GetModel(target.List(null))?.PagingIn 


fo.Totalitems; 


// Assert 

Assert.Equal(2, 
Assert.Equal(2, 
Assert.Equal(1, 
Assert.Equal(5, 





resi); 
res2); 
res3); 
resAll); 


请 注意 ， 以 上 代码 在 没有 指定 类 别 的 情况 下 调 


FAS List®R(E AE, 


以 确保 得 到 正确 的 总 数 。 


9.2 构建 购物 车 


现在 应 用 程序 进展 顺利 ， 但 在 实现 购物 车 之 
前 ， 无 法 销售 任何 商品 。 图 9-7 展 示 了 基本 的 购物 
流程 。 在 网 上 购物 的 人 虱 会 熟悉 这 一 流程 。 





Enter shipping details 
eels 














图 9-7 基本 的 购物 流程 


目录 中 每 个 产品 的 劳 边 都 会 显示 Add to Cart 按 
钮 ， 单 击 此 按钮 将 显示 客户 目前 所 选 商品 的 摘要 ， 
包括 总 价 。 此 时 ， 用 户 可 以 单 击 Continue Shopping 
按钮 返回 商品 目录 ， 或 单 击 Checkout Now 按 钮 完成 
订单 并 结束 购物 流程 。 














9.2.1 定义 购物 车 模型 


将 一 个 名 为 Cartcs 的 类 文件 添加 到 Models 文 件 
夹 中 ， 并 用 它 定义 代码 清单 9-13 所 示 的 类 。 





代码 清单 9-13 Models 文 件 夹 下 的 Cart.cs 文 件 的 内 容 





using System.Collections.Generic; 
using System.Ling; 


namespace SportsStore.Models { 


public class Cart { 
private List<CartLine> lineCollection = new Lis 
t<CartLine>(); 


public virtual void AddItem(Product product, in 
t quantity) { 
CartLine line = lineCollection 
.Where(P => p.Product.ProductID == prod 
uct.ProductID) 
.FirstOrDefault(); 


if (line == null) { 
lineCollection.Add(new CartLine { 
Product = product, 
Quantity = quantity 
})3 
} else { 
line.Quantity += quantity; 
} 


public virtual void RemoveLine(Product product) 


lineCollection.RemoveAl1l(1 => 1.Product.Pro 
ductID == product.ProductID) ; 


public virtual decimal ComputeTotalValue() => 
lineCollection.Sum(e => e.Product.Price * e 
.Quantity ) ; 


public virtual void Clear() => lineCollection.C 
lear(); 


public virtual IEnumerable<CartLine> Lines => 1 
ineCollection; 


} 


public class CartLine { 
public int CartLineID { get; set; } 
public Product Product { get; set; } 
public int Quantity { get; set; } 


} 
} 





在 以 上 代码 中 ，Cart 类 使 用 在 同一 文件 中 定义 
的 CartLine 类 来 表示 客户 选择 的 商品 和 用 户 想 要 购 
买 的 数量 ， 还 定义 了 以 下 功能 : 将 商品 添加 到 购物 
车 ， 从 购物 车 中 删除 以 前 添加 的 商品 ， 计 算 购 物 车 
中 商品 的 总 价格 ， 以 及 通过 删除 所 有 商品 重 置 购 物 
车 。 另 外 ， 还 添加 了 一 个 属性 ， 让 你 可 以 使 用 
IEnumerable<CartLine> 访 问 购 物 车 的 内 容 。 这 些 内 
容 比较 简单 ， 使 用 C# 的 LINQ 可 以 轻松 实现 。 








持 元 测试 一 一 测试 购物 车 





Cart 类 相对 人 简单， 但 它 有 一 系列 重要 的 行为 ， 


必须 能 够 正常 工作 。 功 能 糟糕 的 购物 车 会 破坏 整个 
SportsStore 应 用 程序 。 我 们 已 经 分 解 了 这 些 功 能 3》 
单独 测试 了 它们 。 在 SportsStore.Tests 项 目 中 创建 一 
个 名 为 CartTests.cs 的 单元 测试 文件 ， 其 中 包含 这 些 
训 试 。 





第 一 个 行为 涉及 何 时 将 一 个 商品 添加 到 购物 
车 。 如 果 这 是 第 一 次 将 给 定 的 商品 添加 到 购物 车 ， 
那么 需要 添加 一 个 新 的 CartLine 对 象 。 以 下 是 包括 
单元 测试 类 定义 的 测试 : 





using System.Ling; 
using SportsStore.Models; 
using Xunit; 


namespace SportsStore.Tests { 


public class CartTests { 
[Fact] 
public void Can_Add_New_Lines() { 


// Arrange - create some test products 

Product p1 = new Product { ProductID = 1, N 
ame = "Pi" }; 

Product p2 = new Product { ProductID = 2, N 


ame = "P2" }; 


// Arrange - create a new cart 
Cart target = new Cart(); 


// Act 

target.AddItem(p1, 1); 

target.AddItem(p2, 1); 

CartLine[] results = target.Lines.ToArray() 


// Assert 

Assert.Equal(2, results.Length) ; 
Assert.Equal(p1, results[@].Product) ; 
Assert.Equal(p2, results[1].Product) ; 





(Bre, MRE POR a es Pe, VN 
要 增加 相应 的 CartLine 对 象 的 数量 ， 而 不 是 创建 一 
个 新 的 。 测 试 如 下 : 





[Fact] 
public void Can_Add_Quantity_For_Existing_Lines() { 
// Arrange - create some test products 
Product p1 = new Product { ProductID = 1, Name 
1" }; 
Product p2 = new Product { ProductID = 2, Name 
2" }; 


ll 
ae) 


ll 
ae) 


// Arrange - create a new cart 
Cart target = new Cart(); 


// Act 
target .AddiItem(p1, 1); 
target .AddiItem(p2, 1); 
target.AddItem(p1, 10); 
CartLine[] results = target.Lines 
.OrderBy(c => c.Product.ProductID).ToArray(); 


// Assert 

Assert.Equal(2, results.Length) ; 
Assert.Equal(11, results[@].Quantity) ; 
Assert.Equal(1, results[1].Quantity) ; 











男 外 ， 还 需要 检查 客户 是 否 可 以 改变 主意 ， 并 
从 购物 车 中 删除 商品 。 该 功能 由 RemoveLine 方 法 实 
EM。 测试 如 下 : 





[Fact] 
public void Can_Remove_Line() { 
// Arrange - create some test products 
Product p1 = new Product { ProductID = 1, Name 
1" F; 
Product p2 = new Product { ProductID = 
2" }; 
Product p3 = new Product { ProductID = 
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3 ”小 


// Arrange - create a new cart 

Cart target = new Cart(); 

// Arrange - add some products to the cart 
target .AddiItem(p1, 1); 

target.AddItem(p2, 3); 

target .AddiItem(p3, 5); 

target .AddItem(p2, 1); 


// Act 
target.RemoveLine(p2) ; 


// Assert 

Assert.Equal(@, target.Lines.Where(c => c.Product = 
= p2).Count()); 

Assert.Equal(2, target.Lines.Count()); 








这 里 想 要 测试 的 下 一 个 行为 是 计算 购物 车 中 商 


品 的 总 价 。 以 下 古 对 此 行为 的 测试: 


Em! 





[Fact] 
public void Calculate_Cart_Total() { 

// Arrange - create some test products 

Product p1 = new Product { ProductID = 1, Name = "P 
1", Price = 100M }; 

Product p2 = new Product { ProductID = 2, Name = "P 
2", Price = 50M }; 


// Arrange - create a new cart 
Cart target = new Cart(); 


// Act 

target .AddItem(p1, 1); 

target .AddiItem(p2, 1); 

target.AddItem(p1, 3); 

decimal result = target.ComputeTotalValue() ; 


// Assert 
Assert.Equal(45@M, result); 





最 后 的 测试 很 简单 。 确 保 在 重 置 购物 车 时 正确 
删除 了 购物 车 的 内 容 。 测 试 如 下 : 





[Fact] 
public void Can_Clear_Contents() { 
// Arrange - create some test products 


Product p1 = new Product { ProductID = 1, Name = "P 
Price = 100M }; 
Product p2 = new Product { ProductID = 2, Name = "P 


Price = 56M }; 


// Arrange - create a new cart 
Cart target = new Cart(); 


// Arrange - add some items 
target.AddItem(p1, 1); 
target.AddItem(p2, 1); 


// Act - reset the cart 
target.Clear(); 


// Assert 
Assert.Equal(@, target.Lines.Count()); 





在 本 例 中 ， 有 时 测试 美的 功能 所 需 的 代码 相 比 
类 本 身 更 多 、 更 复杂 。 不 要 因为 复杂 融 放 茎 单元 训 





试 。 简 单 关 中 的 缺陷 可 能 会 产生 巨大 的 影响 ， 特 别 
是 在 示例 应 用 程序 中 扮演 重要 作用 的 一 些 类 ， 比 如 


Cart 类 。 


9.2.2 ”添加 Add To Cart 按 钮 


这 里 需要 编辑 
Views/Shared/ProductSummary.cshtml 分 部 视图 以 将 
按钮 添加 到 商品 列表 中 。 为 准备 此 功能 ， 这 里 将 一 
个 名 为 UrlIExtensions.cs 的 类 文件 添加 到 Infrastructure 





文件 夹 中 ， 并 定义 了 扩展 方法 ， 如 代码 清单 9-14 所 
示 。 


代码 清单 9-14_ Infrastructure 文件 夹 下 的 UrlExtensions.cs 文 件 的 
内 容 


using Microsoft.AspNetCore.Http; 
namespace SportsStore.Infrastructure { 


public static class UrlExtensions { 


public static string PathAndQuery(this HttpRequ 


est request) => 
request.QueryString.HasValue 
? $"{request.Path}{request.QueryString} 


: request.Path.ToString(); 








PathAndQuery 扩 展 方 法 在 HttpRequest 类 上 执行 
操作 ，ASP.NET 则 使 用 HttpRequest 类 来 描述 HTTP 
请 求 。 该 扩展 方法 会 生成 一 个 URL， 浏 览 右 将 在 购 
物 车 更 新 后 返回 ， 并 将 查询 字 符 串 考虑 在 内 〈 如 果 








有 的 话 ) 。 在 代码 清单 9-15 中 ， 将 包含 扩展 方法 的 
命名 空间 添加 到 视图 寻 入 文件 中 ， 以 便 在 分 部 视图 
中 使 用 它 。 








代码 清单 9-15 ”在 Views 文 件 夹 下 的 _ViewImports.cshtml 文 件 中 
添加 命名 空间 
@using SportsStore.Models 


@using SportsStore.Models.ViewModels 
@using SportsStore. Infrastructure 


@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 
@addTagHelper SportsStore.Infrastructure.*, SportsStore 








在 代码 清单 9-16 中 ， 已 经 更 新 了 描述 每 个 商品 
的 分 部 视图 ， 以 包含 Add To Cart 按 钮 。 


代码 清单 9-16 ”将 按钮 添加 到 Views/Shared 文 件 夹 下 的 
ProductSummary.cshtml 文 件 中 





@model Product 


<div class="card card-outline-primary m-1 p-1"> 
<div class="bg-faded p-1"> 
<h4> 
@Model .Name 
<span class="badge badge-pill badge-primary 


" style="float:right"> 
<small>@Model.Price.ToString("c")</smal 
l> 
</span> 
</h4> 
</div> 
<form id="@Model.ProductID" asp-action="AddToCart" 
asp-controller="Cart" method="post"> 
<input type="hidden" asp-for="ProductID" /> 
<input type="hidden" name="returnUr1" 
value="@ViewContext.HttpContext.Request. 
PathAndQuery()" /> 
<span class="card-text p-1"> 
@Model.Description 
<button type="submit" 
class="btn btn-success btn-sm pull-righ 
t" style="float:right"> 
Add To Cart 


</button> 
</span> 
</form> 
</div> 








文 里 添加 了 一 个 form 元 素 ， 其 中 包含 隐藏 的 
input, HX EMERE HH e ; 
及 更 新 购物 车 后 浏览 器 应 返回 的 URL。form 元 素 和 和 
其 中 一 个 input 元 素 是 使 用 内 置 标 签 助手 配置 的 ， 
是 一 种 很 有 用 的 方式 ， 可 以 生成 包含 模型 值 的 表 
单 ， 并 在 应 用 程序 中 定位 控制 器 和 操作 ， 如 第 24 章 











所 述 。 男 一 个 input 元 素 使 用 这 里 创建 的 扩展 方法 来 
设置 返回 的 URL。 这 里 还 添加 了 一 个 button 元 素 ， 
用 来 将 表单 提交 给 应 用 程序 。 


We 
y Rect 
ee 


这 里 已 将 form 元 素 的 method 属 性 设置 为 post， 
这 指示 浏览 器 使 用 HTTP POST 请 求 提交 表单 数据 。 
可 以 更 改 此 设置 ， 以 便 表 单 使 用 GET 方 法 ， 但 应 该 
BEZE. HTTP ALE BER GET te RVE 
的 ， 这 意味 看 它们 不 能 导致 更 改 ， 但 将 商品 添加 到 
购物 车 绝对 是 一 种 更 改 。 第 16 章 将 介绍 有 关 这 个 主 
题 的 更 多 内 容 ， 包 括 解 释 如 末 忽 略 虹 等 GET 请 求 的 
需求 ， 可 能 会 及 生 什 么 情况 。 








9.2.3 ”局 用 会 话 





这 里 将 使 用 会 话 状态 存储 用 户 购 物 车 的 详细 信 
轧 ， 会 话 状态 是 存储 在 服务 器 上 并 与 用 户 发 出 的 一 
系列 请 求 相 关联 的 数据 。ASP.NET 提 供 了 多 种 不 同 
方式 来 存储 会 话 状 态 ， 包 括 将 其 存储 在 内 存 中 ， 这 
也 是 这 里 将 要 使 用 的 方式 。 这 种 方式 的 优点 是 简 
单 ， 但 意味 着 当 应 用 程序 俘 止 或 重新 局 动 时 会 话 数 
据 会 丢失 。 启 用 会 话 需 要 在 Startup 类 中 添加 服务 和 
中 间 件 ， 如 代码 清单 9-17 所 示 。 





代码 清单 9-17 在 SportsStore 文 件 夹 下 的 Startup.cs 文 件 中 启用 


会 请 





using System; 

using System.Collections.Generic; 
using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 
using Microsoft.AspNetCore.Hosting; 


using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using SportsStore.Models; 

using Microsoft.Extensions.Configuration; 

using Microsoft.EntityFrameworkCore; 


namespace SportsStore { 
public class Startup { 


public Startup(IConfiguration configuration) => 
Configuration = configuration; 


public IConfiguration Configuration { get; } 


public void ConfigureServices(IServiceCollectio 
n services) { 
services .AddDbContext<ApplicationDbContext> 
(options => 
options.UseSqlServer ( 
Configuration[ "Data:SportStoreProdu 
cts:ConnectionString"])); 
services.AddTransient<IProductRepository, E 
FProductRepository>() ; 
services.AddMvc(); 
services.AddMemoryCache() ; 
services.AddSession() ; 
} 
public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages() ; 
app.UseStaticFiles(); 
app.UseSession() ; 
app.UseMvc(routes => { 


// ...routing configuration omitted for 
brevity... 


}); 
SeedData.EnsurePopulated(app); 





可 调用 AddMemoryCache 方 法 来 设置 内 存 数 所 
存储 。AddSession 方 法 用 来 注册 用 于 访问 会 话 数据 
的 服务 ，UseSession 方 法 允许 会 话 系 统 在 从 客户 端 
到 达 时 目 动 将 请 求 与 会 话 相关 联 。 








9.2.4 ”实现 Cart 控 制 器 


这 里 震 要 一 个 控制 器 来 处 理 Add to Cart 按 钮 。 
在 Controllers 文 件 夹 中 添加 一 个 名 为 
CartController.cs 的 类 文件 ， 并 用 它 定义 代码 清单 9- 
18 所 示 的 类 。 


代码 清单 9-18 ”Controllers 文 件 夹 下 的 CartController.cs 文 件 的 
内 容 





using System.Ling; 

using Microsoft.AspNetCore.Http; 
using Microsoft.AspNetCore.Mvc; 
using SportsStore.Infrastructure; 
using SportsStore.Models; 


namespace SportsStore.Controllers { 


public class CartController : Controller { 
private IProductRepository repository; 


public CartController(IProductRepository repo) 


repository = repo; 


} 


public RedirectToActionResult AddToCart(int pro 
ductId, string returnUrl) { 
Product product = repository .Products 
.FirstOrDefault(p => p.ProductID == pro 


ductId); 
if (product != null) { 
Cart cart = GetCart(); 
cart.AddItem(product, 1); 
SaveCart(cart); 
} 
return RedirectToAction("Index", new { retu 
rnUrl }); 
} 


public RedirectToActionResult RemoveFromCart(in 
t productId, 
string returnUrl) { 
Product product = repository.Products 


.FirstOrDefault(p => p.ProductID == pro 


ductId); 
if (product != null) { 
Cart cart = GetCart(); 
cart.RemoveLine(product) ; 
SaveCart(cart) ; 
return RedirectToAction("Index", new { retu 
rnUrl }); 


private Cart GetCart() { 
Cart cart = HttpContext.Session.GetJson<Car 
t>("Cart") ?? new Cart(); 
return cart; 


} 


private void SaveCart(Cart cart) { 
HttpContext.Session.SetJson("Cart", cart); 





关于 这 个 控制 器 有 几 点 需要 注意 。 首 先 ， 使 用 
ASP.NET 会 话 状 态 功能 来 存储 和 检索 Cart 对 象 ， 
是 GetCart 方 法 的 目的 。 前 面 在 9.2.3 节 中 注册 的 中 间 
件 使 用 Cookie 或 URL 重 写 将 来 自 一 个 用 户 的 多 个 请 
求 关 联 在 一 起 以 形成 单个 浏览 会 话 。 相 关 的 功能 是 





会 话 状态 ， 用 于 将 数据 与 会 话 相 关联 。 这 是 Cart 关 
的 理想 选择 : 硕 望 每 个 用 户 都 有 目 己 的 购物 车 ， 并 

且 和 希望 购物 车 在 请 求 之 间 保持 一 致 。 会 话 过 期 时 会 
删除 与 会 话 关 联 的 数据 ( 通 Ea BEN 
AA AH ER) , Reba hi 2 E E 
Cart 对 象 的 存储 或 生命 周期 。 

















对 于 AddToCart 和 RemoveFromCart 操 作 方 法 ， 
可 以 使 用 与 ProductSummary.cshtml 视 图 文件 中 创建 
的 HTML 表 单 中 的 input 元 素 逻 配 的 参数 名 称 。 这 人 允 
许 MVC 将 表单 传 入 的 POST 变量 与 这 些 参数 相关 
联 ， 进 而 意味 着 不 需要 上 自己 处 理 表 单 。 这 称 为 模型 
绑 定 ， 模 型 绑 定 简化 控制 右 关 的 强大 工具 ， 正 如 第 
26 章 解释 的 那样 。 











会 话 状 态 扩展 方法 


ASP.NET Core 中 的 会 话 状 态 功能 仅 存 储 int、 


string 和 byte[] 值 。 由 于 需要 存储 Cart 对 象 ， 因 此 盐 
要 为 ISession 接 口 定义 扩展 方法 ，ISession 接 口 提供 
对 会 话 状 态 数 据 的 访问 ， 以 将 Cart 对 象 序 列 化 为 
JSON 并 将 其 转换 回来 。 在 Infrastructure 文 件 夹 中 添 
加 名 为 SessionExtensions.cs 的 类 文件 ， 并 定义 代码 
清单 9-19 所 示 的 扩展 方法 。 


代码 清单 9-19 Infrastructure XF% F HJ SessionExtensions.cs X 
件 的 内 容 





using Microsoft.AspNetCore.Http; 
using Newtonsoft.Json; 


namespace SportsStore.Infrastructure { 
public static class SessionExtensions { 


public static void SetJson(this ISession sessio 
n, string key, object value) { 
session.SetString(key, JsonConvert.Serializ 
eObject(value)); 
} 


public static T GetJson<T>(this ISession sessio 
n, string key) { 
var sessionData = session.GetString (key) ; 
return sessionData == null 


? default(T) : JsonConvert.DeserializeObjec 
t<T>(sessionData) ; 


I 


} 





这 些 方 法 依赖 于 Json.Net 包 并 将 对 象 序列 化 为 
JavaScript Object Notation 格 式 ， 你 将 在 第 20 章 中 再 
次 遇 到 这 种 格式 。Json.Net 包 不 必 添 加 到 项 目 中 ， 
因为 MVC 己 经 默认 集成 了 它 ， 用 来 捉 供 JSON 助 手 
功能 ， 如 第 21 章 所 述 (有关 使 用 Json.Net 包 的 信 


息 ， 请 参阅 newtonsoft 网 站 ) 。 


扩展 方法 可 以 轻松 存储 和 检索 Cart 对 象 。 要 在 
控制 右 中 将 Cart 添 加 到 会 话 状 态 ， 可 以 这 样 做 : 


HttpContext.Session.SetJson("Cart", cart); 





HttpContext}® V£ FH Controller He fk, fas iil] as 


通常 从 Controller 基 类 派生 ， 并 返回 一 个 HttpContext 





对 象 ， 访 对象 提 供 有 关 已 接收 的 请 求 和 正在 准备 的 
啊 应 的 上 下 文 数 据 。HttpContext.Session 属 性 会 返回 
一 个 实现 了 ISession 接 口 的 对 象 ，ISession 接 口 定义 
了 SetJson 方 法 的 类 型 ，SetJson 方 法 接收 一 些 参数 ， 
指定 了 一 个 键 和 要 添加 到 会 话 状态 的 对 象 。 扩 展 方 
法 会 序列 化 对 象 ， 并 使 用 ISession 接 口 提 供 的 基础 
功能 将 其 添加 到 会 话 状 态 中 。 








再 次 检索 购物 车 ， 使 用 男 一 种 扩展 方法 ， 但 指 
定 相 同 的 键 ， 如 下 所 示 : 





Cart cart = HttpContext.Session.GetJson<Cart>("Cart") ; 


类 型 参数 用 于 指定 要 检索 的 关 型 ， 用 于 反 序 列 
化 过 程 。 


9.2.5 ”显示 购物 车 的 内 容 


关于 Cart 控 制 句 的 最 后 一 点 是 ，AddToCart 和 
RemoveFromCart 方 法 都 调用 RedirectToAction 方 
法 。 这 具有 问 客 户 站 浏览 融 发 送 HTTP 重 定 癌 指令 
的 效果 ， 要 求 浏览 器 请 求 新 的 URL。 在 这 种 情况 
下 ， 我 们 已 经 要 求 浏览 器 请 求 一 个 URL， 该 URL 将 
调用 Cart 控 制 器 的 mdex 操 作 方 法 。 





实现 Index 操 作 方 法 并 用 它 来 显示 购物 车 的 内 
容 。 如 果 回 头 参 考 图 9-7， 你 将 看 到 这 是 用 户 单 击 
Add to Cart 按 钮 时 的 工作 流程 。 





需要 将 两 条 信息 传递 给 显示 购物 车 内 容 的 视 
图 ， 分 别 是 Cart 对 象 以 及 用 户 单 击 Continue 
Shopping 按 钮 时 显示 的 URL。 在 SportsStore 项 目的 
Models/ViewModels 文 件 夹 中 创建 名 为 
CartIndexViewModel.cs 的 类 文件 ， 并 用 它 定 义 代码 
清单 9-20 所 示 的 类 。 


代码 清单 9-20 ”Models/ViewModels 文 件 夹 下 的 
CarthdexViewModel.cs 文 件 的 内 容 


using SportsStore.Models; 


namespace SportsStore.Models.ViewModels { 


public class CartIndexViewModel { 
public Cart Cart { get; set; } 
public string ReturnUrl { get; set; } 





现在 有 了 视图 模型 ， 可 以 在 Cart 控 制 器 类 中 实 
现 Index 操 作 方 法 了 ， 如 代码 清单 9-21 所 示 。 


代码 清单 9-21 在 Controllers 文 件 夹 下 的 CartController.cs 文 件 
中 实现 Index 操作 方法 





using System.Ling; 

using Microsoft.AspNetCore.Http; 
using Microsoft.AspNetCore.Mvc; 
using SportsStore.Infrastructure; 
using SportsStore.Models; 

using SportsStore.Models.ViewModels ; 


namespace SportsStore.Controllers { 


public class CartController : Controller { 


private IProductRepository repository; 
public CartController(IProductRepository repo) 


repository = repo; 


public ViewResult Index(string returnUrl) { 
return View(new CartIndexViewModel { 
Cart = GetCart(), 
ReturnUrl = returnUrl 
}); 
} 


// ...other methods omitted for brevity... 





Index 操 作 方 法 从 会 话 状态 检索 Cart 对 象 ， 并 使 
用 它 创 建 CartIndexViewModel 对 象 ， 然 后 将 其 作为 
视图 模型 传递 给 View 方 法 。 





显示 购物 车 内 容 的 最 后 一 步 是 创建 Index 操作 
方法 将 要 呈现 的 视图 。 创 建 Views/Cart 文 件 夹 ， 并 
在 其 中 添加 一 个 名 为 Index.cshtml 的 Razor 视 图 文 
件 ， 其 中 的 内 容 如 代码 清单 9-22 所 示 。 


代码 清单 9-22 Views/Cart 文 件 夹 下 的 Index.cshtml 文 件 的 内 容 





@model CartIndexViewModel 


<h2>Your cart</h2> 
<table class="table table-bordered table-striped"> 
<thead> 
<tr> 
<th>Quantity</th> 
<th>Item</th> 
<th class="text-right">Price</th> 
<th class="text-right">Subtotal</th> 


</tr> 
</thead> 
<tbody> 
@foreach (var line in Model.Cart.Lines) { 
<tr> 
<td class="text-center">@line.Quantity< 
/td> 
<td class="text-left">@line.Product.Nam 
e</td> 


<td class="text-right">@line.Product.Pr 
ice. ToString("c")</td> 
<td class="text-right"> 
@((line.Quantity * line.Product.Pri 
ce). ToString("c")) 


</td> 
</tr> 
} 
</tbody> 
<tfoot> 
<tr> 


<td colspan="3" class="text-right">Total:</ 
td> 


<td class="text-right"> 
@Model.Cart.ComputeTotalValue().ToStrin 
g("c") 
</td> 
</tr> 
</tfoot> 
</table> 


<div class="text-center"> 

<a class="btn btn-primary" href="@Model.ReturnUr1"> 
Continue Shopping</a> 
</div> 








这 个 视图 枚 举 了 购物 车 中 的 行 ， 并 将 其 中 的 每 
行 以 及 每 行 的 总 价 和 购物 车 的 总 价 添 加 到 HIML 表 
格 中 。 为 了 让 表格 和 文本 对 齐 ， 可 以 为 这 些 元 系 分 
配 与 Bootstrap 样 式 对 应 的 class 样 式 。 


购物 车 的 基本 功能 已 完成 。 首 先 ， 列 出 的 商品 
劳 边 有 一 个 按钮 ， 用 来 将 它们 琴 加 到 购物 车 中 ， 如 
图 9-8 所 示 。 
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图 9-8 Add to Cart 按 钮 


其 次 ， 当 用 户 单 击 Add to Cart 按 钮 时 ， 相 应 的 
商品 将 被 添加 到 购物 车 中 ， 并 显示 购物 车 的 摘要 ， 
如 图 9-9 所 示 。 单 击 Continue Shopping 按 钮 可 让 用 户 
返回 之 前 的 商品 页 面 。 


大 °° 





e Œ | O localhost:60000/Cart/Index?retumUrl=%2FPage1 tw!) : 

Home Your cart 

Chess Quantity Item Price Subtotal 

Soc 1 Unsteady Chair $29.95 $29.95 

Watersport 1 Thinking Cap $16.00 $16.00 

1 Human Chess Board $75.00 $75.00 

1 Kayak $275.00 $275.00 

Total $395.95 











图 9-9 ”显示 购物 车 的 内 容 





本 间 介 绍 了 如 何 实现 SportsStore 应 用 程序 面 问 





方法 ， 并 将 基础 构建 模块 准备 就 绪 ， 以 便 将 商品 添 
加 到 购物 车 。 此 外 ， 还 有 更 多 工作 要 做 ， 我 们 将 在 
下 一 草 继 续 开 有 该 应 用 程序 。 


第 10 章 ”完成 购物 车 


本 草 将 继续 介绍 如 何 构建 SportsStore 示 例 应 用 
程序 。 在 上 一 章 中 ， 我 们 添加 了 购物 车 的 基本 功 
能 ， 现 在 将 改进 并 完成 这 些 功 能 。 


10.1 使 用 服务 优化 购物 车模 型 


上 一 章 定 义 了 Cart 模 型 类 ， 并 展示 了 如 何 使 用 
会 话 功 能 来 存储 它 ， 从 而 允许 用 户 保 存 一 组 已 购买 
的 商品 。Cart 类 的 持久 化 是 由 Cart 控 制 器 管理 的 ， 
Cart 控 制 占 明确 地 定义 了 获取 和 存储 Cart 对 象 的 方 
rae 








这 种 方式 的 问题 是 ， 为 了 获取 并 存储 Cart 对 
象 ， 必 须 在 所 有 使 用 它们 的 组 件 中 复制 这 些 代 码 。 
在 本 节 中 ， 将 使 用 ASP.NET Core 的 服务 功能 来 简化 





Cart 对 象 的 管理 方式 ， 释 放 诸如 Cart 控 制 左 的 各 个 
组 件 ， 从 而 无 须 直 接 处 理 细 市 。 





服务 的 最 利用 方式 是 隐藏 接口 从 依赖 于 它们 的 
组 件 进行 实例 化 的 细节 。 你 已 经 看 到 了 一 个 例子 ， 
就 是 为 IProductRepository 接 口 创 建 一 个 服务 ， 这 使 
你 能 够 无 颖 地 将 虚拟 存储 库 类 用 Entity Framework 
Core 和 存储 库 蔡 换 掉 。 但 服务 也 可 用 于 解决 许多 其 他 
问题 ， 并 且 可 以 用 于 组 成 和 重 构 应 用 程序 ， 即 使 正 
在 使 用 具体 的 类 ， 如 Cart 类 。 








10.1.1 创建 支持 存储 感知 的 Cart 类 








整理 Cart 类 的 使 用 方式 的 第 一 步 是 创建 一 个 子 
类 ， 访 子 类 能 够 知道 如 何 使 用 会 话 状态 来 存储 自 
己 。 添 加 一 个 名 为 SessionCartcs 的 类 文件 到 Models 
文件 夹 中 ， 并 用 它 定 义 代 码 清单 10-1 所 示 的 类 。 








代码 清单 10-1 Models 文 件 夹 下 的 SessionCart.cs 文 件 的 内 容 





uSing System; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Newtonsoft.Json; 

using SportsStore. Infrastructure; 


namespace SportsStore.Models { 


public class SessionCart: Cart { 
public static Cart GetCart(IServiceProvider ser 
vices) { 
ISession session = services.GetRequiredServ 
ice<IHttpContextAccessor>()? 
.HttpContext.Session; 
SessionCart cart = session?.GetJson<Session 
Cart>("Cart") 
?? new SessionCart(); 
cart.Session = session; 
return cart; 


} 


[JsonIgnore] 
public ISession Session { get; set; } 


public override void AddItem(Product product, i 
nt quantity) { 
base.AddItem(product, quantity); 
Session.SetJson("Cart", this); 


} 


public override void RemoveLine(Product product 


) 1{ 


base.RemoveLine(product) ; 
Session.SetJson("Cart", this); 


public override void Clear() { 
base.Clear(); 
Session.Remove("Cart") ; 





SessionCart Cat SR, FFAS y 
AddItem、RemoveLine 和 Clear 方 法 ， 从 而 调用 基本 
实现 ， 然 后 使 用 第 9 和 章 定 义 的 ISession 接 口上 的 扩展 
方法 将 更 新 后 的 状态 存储 在 会 话 中 。 静 态 方法 
GetCart 是 一 个 工厂 ， 用 于 创建 SessionCart 对 象 并 为 
它们 提供 一 个 ISession 对 象 ， 以 便 它们 可 以 存储 目 
向 。 掌 握 ISession 对 象 有 点 复 人 森 。 必 须 获 得 
IHttpContextAccessor 服 务 的 一 个 实例 ， 该 服务 提供 
对 HttpContext 对 象 的 访问 ， 而 HttpContext 对 象 义 提 
供 了 ISession。 这 种 间接 方法 是 必需 的 ， 因 为 会 话 
不 是 作为 弟 规 服务 提供 的 。 











10.1.2 ”注册 服务 





下 一 步 是 为 Cart 类 创建 一 个 服务 。 目 标 是 使 用 
SessionCart 对 象 来 满足 Cart 对 象 的 请 求 ， 这 些 对 象 
将 无 颖 地 存储 自身。 代码 清单 10-2 展 示 了 如 何 创 建 
服务 。 





代码 清单 10-2 在 SportsStore 文 件 夹 下 的 Startup.cs 文 件 中 创建 
购物 车 服务 


public void ConfigureServices(IServiceCollection servic 


es) { 


services .AddDbContext<ApplicationDbContext> (options 


=> 
options.UseSqlServer ( 
Configuration[ "Data:SportStoreProducts:Conn 
ectionString"])); 
services.AddTransient<IProductRepository, EFProduct 
Repository>(); 
services .AddScoped<Cart>(sp => SessionCart.GetCart( 
sp)); 
services .AddSingleton<IHttpContextAccessor, HttpCon 
textAccessor>(); 
services.AddMvc(); 
services .AddMemoryCache() ; 
services.AddSession(); 





AddScoped 方 法 指定 应 使 用 相同 的 对 象 来 满足 
Cart 实 例 的 相关 请 求 。 请 求 乙 间 的 关系 是 可 以 配置 
的 ， 但 默认 情况 下 ， 这 意味 着 处 理 相同 HTTP 请 求 
的 组 件 所 需 的 任何 Cart 都 将 接收 到 相同 的 对 象 。 








这 里 没有 像 为 存储 库 那 样 为 AddScoped 方 法 提 
供 类 型 映射 的 AddScoped 方 法 ， 而 是 指定 了 一 个 
Lambda 表 达 式 ， 这 个 Lambda 表 达 式 将 被 调用 以 满 
足 Cart 请 求 。 这 个 Lambda 表 达 式 接收 已 注册 的 服务 
慌 合 ， 并 将 集合 传递 给 SessionCart 类 的 GetCart 方 
法 。 结 果 是 ， 对 Cart 服 务 的 请 求 将 通过 创建 
SessionCart 对 象 来 处 理 ， 当 这 些 对 象 被 修改 时 ， 会 
将 上 自己 序列 化 为 会 话 数 据 。 











这 里 还 使 用 AddSingleton 方 法 添加 了 一 个 服 
务 ， 该 方法 指定 应 始终 使 用 相同 的 对 象 ， 该 服务 告 
诉 MVC 在 需要 IHttpContextAccessor 接 口 的 实现 时 使 
用 HttpContextAccessor 类 。 该 服务 是 必需 的 ， 因 此 


在 这 里 可 以 访问 代码 清单 10-1 中 的 SessionCart 类 中 
的 当前 会 话 。 


10.1.3 ”人 简化 Cart 控 制 器 


创建 这 种 服务 的 好 处 是 能 够 简化 使 用 Cart 对 象 
的 控制 占 。 通 过 代码 清 时 10-3， 重 新 设计 
CartController 类 以 利用 新 服务 。 





代码 清单 10-3 ”在 Controllers 文 件 夹 下 的 CartController.cs 文 件 
中 使 用 购物 车 服务 





using System.Ling; 

using Microsoft.AspNetCore.Mvc; 
uSing SportsStore.Models; 

using SportsStore.Models.ViewModels ; 


namespace SportsStore.Controllers { 


public class CartController : Controller { 
private IProductRepository repository; 
private Cart cart; 


public CartController(IProductRepository repo, 
Cart cartService) { 
repository = repo; 
cart = cartService; 


public ViewResult Index(string returnUrl) { 
return View(new CartIndexViewModel { 
Cart = cart, 
ReturnUrl = returnUrl 


}); 
} 


public RedirectToActionResult AddToCart(int pro 
ductId, string returnUrl) { 
Product product = repository .Products 
.FirstOrDefault(p => p.ProductID == pro 


ductId); 
if (product != null) { 
cart.AddItem(product, 1); 
} 
return RedirectToAction("Index", new { retu 
rnUrl }); 
} 


public RedirectToActionResult RemoveFromCart(in 
t productId, 
string returnUrl) { 
Product product = repository.Products 
.FirstOrDefault(p => p.ProductID == pro 


ductId); 
if (product != null) { 
cart.RemoveLine(product) ; 
} 
return RedirectToAction("Index", new { retu 
rnUrl }); 
} 


} 





CartController 类 通过 声明 构造 函数 的 参数 来 指 
示 这 一 个 Cart 对 象 ， 这 样 束 可 以 删除 从 会 话 读 取 和 和 
写 入 数据 的 方法 以 及 写 入 更 新 所 需 的 步骤 。 其 结 末 
是 一 个 更 简单 的 控制 器 ， 并 且 仍 然 专注 于 它 在 应 用 
程序 中 担负 的 角色 ， 而 不 必 担 心 如 何 创 建 或 持久 化 
Cart 对 象 。 此 外 ， 由 于 服务 在 整个 应 用 程序 中 都 可 
以 使 用 ， 因 此 任何 组 件 都 可 以 使 用 相同 的 技术 来 处 
理 用 户 的 购物 车 。 








10.2 完成 灼 物 车 功能 


既然 上 一 节 已 经 介绍 了 购物 车 服务 ， 现 在 是 时 
候 通过 添加 两 个 新 功能 来 完成 购物 车 功能 了 。 第 一 
个 功能 将 允许 客户 从 购物 车 中 删除 商品 。 第 二 个 功 
能 将 在 页 面 顶部 显示 购物 车 的 摘要 。 





10.2.1 ”从 购物 车 中 删除 商品 


由 于 已 经 在 控制 器 中 定义 并 测试 了 
RemoveFromCart 操 作 方 法 ， 因 此 只 需要 在 视图 中 公 
开 这 个 操作 方法 即 可 让 客户 从 购物 车 中 删除 商品 ， 
可 通过 在 购物 车 摘要 的 每 一 行 中 添加 Remove 投 钮 
来 完成 此 操作 。 代 码 清单 10-4 显 示 了 对 
ViewSs/CarUVIndex.cshtml 文 件 所 做 的 更 改 。 





代码 清单 10-4 将 Remove 按 钮 引入 Views/Cart 文 件 严 下 的 
Index.cshtml 3¢ 4 





@model CartIndexViewModel 


<h2>Your cart</h2> 
<table class="table table-bordered table-striped"> 
<thead> 
<tr> 
<th>Quantity</th> 
<th>Item</th> 
<th class="text-right">Price</th> 
<th class="text-right">Subtotal</th> 
</tr> 
</thead> 
<tbody> 
@foreach (var line in Model.Cart.Lines) { 
<tr> 
<td class="text-center">@line.Quantity< 
/td> 


<td class="text-left">@line.Product.Nam 
e</td> 
<td class="text-right">@line.Product.Pr 
ice. ToString("c")</td> 
<td class="text-right"> 
@((line.Quantity * line.Product.Pri 
ce). ToString("c")) 
</td> 
<td> 
<form asp-action="RemoveFromCart" m 
ethod="post"> 
<input type="hidden" name="Prod 


uctID" 
value="@line.Product.Pro 
ductID" /> 
<input type="hidden" name="retu 
rnUrl" 
value="@Model.ReturnUr1" 
/> 


<button type="submit" class="bt 
n btn-sm btn-danger"> 


Remove 
</button> 
</form> 
</td> 
</tr> 
} 
</tbody> 
<tfoot> 
<tr> 
<td colspan="3" class="text-right">Total:</ 
td> 
<td class="text-right"> 
@Model.Cart.ComputeTotalValue().ToStrin 
g("c") 


</td> 


</tr> 
</tfoot> 
</table> 


<div class="text-center"> 

<a class="btn btn-primary" href="@Model.ReturnUr1"> 
Continue shopping</a> 
</div> 





以 上 代码 在 表格 的 每 一 行 中 添加 了 一 个 新 列 ， 
其 中 包含 一 个 带 有 隐藏 的 input 元 素 的 form 表 单 ， 用 
于 指定 要 删除 的 商品 和 要 返回 的 URL， 以 及 用 于 所 
交 表 单 的 按钮 。 





通过 运行 应 用 程序 并 将 商品 添加 到 购物 车 中 ， 
可 以 查看 Remove 按 钮 如 何 工 作 。 请 记 住 ， 购 物 车 
己 经 包含 删除 商品 的 功能 ， 可 以 通过 单 击 其 中 一 个 
新 的 按钮 来 测试 ， 如 图 10-1 所 示 。 














图 10-1 ”从 购物 车 中 删除 商品 


10.2.2 添加 购物 车 摘要 小 部 件 


里 然 已 经 有 了 功能 正常 的 购物 车 ， 但 也 有 一 个 
问题 : 客户 只 能 得 看 购物 车 摘要 页 面 才 能 了 解 购 物 
车 中 的 两 品 ， 并 且 他 们 只 能 通过 向 购物 车 添加 新 丙 
品 来 得 看 购物 车 摘要 页 面 。 








为 了 解决 这 个 问题 ， 可 添加 一 个 小 部 件 ， 简 要 
显示 购物 车 的 内 容 ， 并 且 单 击 该 小 部 件 束 可 以 在 整 
个 应 用 程序 中 显示 购物 车 的 内 容 。 我 们 以 与 添加 导 
航 小 部 件 相同 的 方式 执行 此 操作 ， 作 为 视图 组 件 ， 
其 输出 可 以 包含 在 Razor 共 享 布局 中 。 





1. 添加 Font Awesome, 





作为 购物 车 摘要 的 一 部 分 ， 需 要 显示 一 个 允许 
用 户 结 账 的 按钮 。 这 里 想 使 用 购物 车 图 标 ， 而 不 是 
在 按钮 上 显示 单词 Checkout。Font Awesome 包 提供 
了 一 组 优秀 的 开源 图 标 ， 可 以 作为 字体 集成 到 应 用 
程序 中 ， 字 体 中 的 每 个 字符 都 是 不 同 的 图 像 。 可 以 
在 GitHub 上 了 解 有 关 Font Awesome 包 的 更 多 信息 ， 
包括 查看 其 中 包含 的 图 标 。 这 里 选择 SportsStore 项 
目 ， 然 后 单 击 Solution Explorer 窗 格 顶 部 的 Show All 
Items 按 钮 以 显示 bower.json 文 件 。 接 下 来 ， 将 Font 
Awesome 包 添加 到 dependencies 部 分 ， 如 代码 清单 
10-5 所 示 。 




















代码 清单 10-5 在 SportsStore 文 件 夹 下 的 bower.json 文 件 中 添加 


Font Awesome 包 





{ 
"name": "asp.net", 
"private": true, 
"dependencies": { 


"bootstrap": "4.0. 
"fontawesome": "4.7. 
} 
} 





保存 bower.json 文 件 后 ，Visual Studio 使 用 
Bower 在 wwwl/lib/fontawesome 文 件 夹 中 下 载 并 安装 
Font Awesome 包 。 


2. 创建 视图 组 件 类 和 视图 


下 面 在 Components 文 件 夹 中 添加 名 为 
CartSummaryViewComponent,cs 的 类 文件 ， 并 用 它 
定义 代码 清单 10-6 所 示 的 视图 组 件 。 


代码 清单 10-6 Components XF% FH 
CartSummaryViewComponent.cs 文 件 的 内 容 





using Microsoft.AspNetCore.Mvc; 
using SportsStore.Models; 


namespace SportsStore.Components { 


public class CartSummaryViewComponent : ViewCompone 
nt { 


private Cart cart; 
public CartSummaryViewComponent(Cart cartServic 


cart = cartService; 


public IViewComponentResult Invoke() { 
return View(cart); 





这 个 视图 组 件 能 够 利用 本 章 前 面 创建 的 服务 ， 
将 Cart 对 象 作 为 构造 函数 的 参数 接收 。 结 果 是 一 个 
简单 的 视图 组 件 类 ， 它 将 Cart 对 象 传递 给 View 方 
法 ， 以 便 生 成 包含 在 布局 中 的 HTML 刻 段 。 为 了 创 
建 布局 ， 创 建 
Views/Shared/Components/CartSummary 文 件 来， 在 
其 中 添加 名 为 Default.cshtml 的 Razor 视 图 文件 ， 并 
添加 代码 清单 10-7 所 示 的 标记 。 








代码 清单 10-7 Views/Shared/Components/CartSummary 文 件 夹 
下 的 Default.cshtml 文 件 的 内 容 


@model Cart 


<div class=""> 
@if (Model.Lines.Count() > ð) { 
<small class="navbar-text"> 
<b>Your cart:</b> 
@Model.Lines.Sum(x => x.Quantity) item(s) 
@Model.ComputeTotalValue().ToString("c") 
</small> 
} 
<a class="btn btn-sm btn-secondary navbar-btn" 
asp-controller="Cart" asp-action="Index" 
asp-route-returnurl="@ViewContext.HttpContext.R 
equest.PathAndQuery()"> 
<i class="fa fa-shopping-cart"></i> 


</a> 
</div> 








钢 图 将 显示 带 有 Font Awesome 购 物 车 图 标的 按 
钮 ， 如 果 购 物 车 中 有 商品 ， 则 会 提供 一 个 页 面 ， 详 
细 说 明 商 品 的 数量 及 总 价 。 现 在 有 了 视图 组 件 和 视 
图 ， 接 下 来 可 以 修改 共享 布局 ， 以 将 购物 车 摘要 包 
含 在 应 用 程序 控制 器 生成 的 啊 应 中 ， 如 代码 清单 
10-8 所 示 。 

















代码 清单 10-8 在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 件 
中 添加 购物 车 摘要 





<!DOCTYPE html> 


<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<link rel="stylesheet" 
asp-href-include="/1lib/bootstrap/dist/**/*.mi 
n.css" 
asp-href-exclude="**/*-reboot*, **/*-grid*" /> 
<link rel="stylesheet" asp-href-include="/1lib/fonta 
wesome/css/*.css" /> 
<title>SportsStore</title> 
</head> 
<body> 
<div class="navbar navbar-inverse bg-inverse" role= 
"navigation" > 
<div class="row"> 
<a class="col navbar-brand" href="#">SPORTS 


STORE</a> 
<div class="col-4 text-right"> 
@await Component. InvokeAsync("CartSumma 
ry") 
</div> 
</div> 
</div> 


<div class="row m-1 p-1"> 
<div id="categories" class="col-3"> 
@await Component. InvokeAsync("NavigationMen 


u") 
</div> 
<div class="col-9"> 
@RenderBody() 
</div> 


</div> 


</body> 
</html> 

可 以 通过 局 动 应 用 程序 来 查看 购物 车 摘要 。 妆 
购物 车 为 空 时 ， 仅 显示 Checkout 按 钮 。 如 果 将 商品 
添加 到 了 购物 车 中 ， 则 会 显示 商品 的 数量 及 总 价 ， 
如 图 10-2 所 示 。 通 过 以 上 修改 ， 客 户 可 以 了 解 购 物 
车 中 的 内 容 ， 并 可 以 方便 地 结账 。 





SPORTS STORE 






$275.00 
Item Price Subtotal -一 一 一 
“一 个 -一 -Am | 


Chess 








图 10-2 ”显示 购物 车 摘要 


10.3 ”提交 订单 





现在 已 经 完成 了 SportsStore 应 用 程序 最 终 面向 
客户 的 功能 一 一 检查 并 完成 订单 。 本 节 将 介绍 如 何 
扩展 域 模 型 ， 文 持 获 取 用 户 的 朔 运 信息 ， 并 添加 应 





用 程序 支持 以 处 理 它 们 。 
10.3.1 创建 模型 类 


在 Models 文 件 夹 中 添加 一 个 名 为 Order.cs 的 类 
文件 ， 内 容 如 代码 清单 10-9 所 示 。 这 是 用 于 表示 客 
户 装 运 信息 的 类 。 


代码 清单 10-9 Models 文 件 夹 下 的 Order.cs 文 件 的 内 容 





using System.Collections.Generic; 
using System.ComponentModel.DataAnnotations; 
using Microsoft.AspNetCore.Mvc.ModelBinding; 


namespace SportsStore.Models { 


public class Order { 


[BindNever ] 

public int OrderID { get; set; } 

[ BindNever | 

public ICollection<CartLine> Lines { get; set; 
} 

[Required(ErrorMessage = "Please enter a name") 
] 


public string Name { get; set; } 


[Required(ErrorMessage = "Please enter the firs 
t address line") ] 

public string Line1 { get; set; } 

public string Line2 { get; set; } 

public string Line3 { get; set; } 


[Required(ErrorMessage = "Please enter a city n 
ame") ] 

public string City { get; set; } 

[Required(ErrorMessage = "Please enter a state 
name") ] 

public string State { get; set; } 

public string Zip { get; set; } 

[Required(ErrorMessage = "Please enter a countr 
y name") ] 


public string Country { get; set; } 


public bool GiftWrap { get; set; } 





45: HH System.ComponentModel.DataAnnotations 
MATPRE TE RE 2 BP Pr HA BB 
样 。 第 27 章 将 进一步 描述 验证 。 


文 里 还 使 用 了 BindNever 特 性 ， 访 特性 会 阻止 
用 户 在 HTTP 请 求 中 为 这 些 属性 提供 值 。 这 是 在 第 


26 章 将 要 描述 的 模型 绑 定 系统 的 特性 之 一 一 一 阻止 
MVC 使 用 HTTP 请 求 中 的 值 来 填充 敏感 或 重要 的 模 
型 属性 。 











10.3.2 ”添加 结账 流程 


为 了 使 用 户 能 够 输入 装运 信息 并 提交 订单 ， 首 
先 需要 在 购物 车 的 摘要 视图 中 话 加 Checkout 按 钮 。 
代码 清单 10-10 显 示 了 对 ViewSs/CarVIndex.cshtml 文 
件 所 做 的 更 改 。 





代码 清单 10-10 “将 Checkout 按 钮 添加 到 ViewsCart 文 件 严 下 的 
Index.cshtml 文 件 中 


<div class="text-center"> 

<a class="btn btn-primary" href="@Model.ReturnUr1"> 
Continue Shopping</a> 

<a class="btn btn-primary" asp-action="Checkout" as 


p-controller="Order"> 
Checkout 
</a> 
</div> 





以 上 更 改 会 生成 一 个 链接 ， 将 其 样式 化 为 按 
钮 ， 并 在 单 击 时 调用 Order 控 制 器 的 Checkout 操 作 方 
法 。 可 以 在 图 10-3 中 看 到 Checkout 按 钮 的 显示 方 
ane 





Quantity Item Price Subtotal 


Soccer 








10-3 Checkoutt<#H 





现在 需要 定义 Order 控 制 器 。 在 Controllers 文 件 
夹 中 添加 一 个 名 为 OrderController.cs 的 类 文件 ， 并 
用 它 定 义 代码 清单 10-11 所 示 的 类 。 


代码 清单 10-11 Controllers 文 件 夹 下 的 OrderController.cs 文 件 
的 内 容 


using Microsoft.AspNetCore.Mvc; 
using SportsStore.Models; 


namespace SportsStore.Controllers { 


public class OrderController : Controller { 


public ViewResult Checkout() => View(new Order( 





Checkout 方 法 返回 默认 视图 ， 并 传递 一 个 新 的 
ShippingDetails 对 象 作为 视图 模型 。 为 了 创建 视 
图 ， 创 建 Views/Order 文 件 夹 并 添加 一 个 名 为 
Checkout.cshtml 的 Razor 视 图 文件 ， 其 中 包含 代码 清 
单 10-12 所 示 的 内 容 。 





代码 清单 10-12 ”Views/Order 文 件 夹 下 的 Checkout.cshtml 文 件 
的 内 容 





@model Order 


<h2>Check out now</h2> 
<p>Please enter your details, and we'll ship your goods 
right away!</p> 


<form asp-action="Checkout" method="post" > 
<h3>Ship to</h3> 
<div class="form-group"> 


<label>Name:</label><input asp-for="Name" class 
="form-control" /> 
</div> 
<h3>Address</h3> 
<div class="form-group"> 
<label>Line 1:</label><input asp-for="Line1i" cl 
ass="form-control" /> 
</div> 
<div class="form-group"> 
<label>Line 2:</label><input asp-for="Line2" cl 
ass="form-control" /> 
</div> 
<div class="form-group"> 
<label>Line 3:</label><input asp-for="Line3" cl 
ass="form-control" /> 
</div> 
<div class="form-group"> 
<label>City:</label><input asp-for="City" class 
="form-control" /> 
</div> 
<div class="form-group"> 
<label>State:</label><input asp-for="State" cla 
ss="form-control" /> 
</div> 
<div class="form-group"> 
<label>Zip:</label><input asp-for="Zip" class=" 
form-control" /> 
</div> 
<div class="form-group"> 
<label>Country:</label><input asp-for="Country" 
class="form-control" /> 
</div> 
<h3>Options</h3> 
<div class="checkbox"> 
<label> 
<input asp-for="GiftWrap" /> Gift wrap thes 


e items 


</label> 
</div> 
<div class="text-center"> 
<input class="btn btn-primary" type="submit" va 
lue="Complete Order" /> 
</div> 
</form> 





对 于 模型 中 的 每 个 属性 ， 创 建 Bootstrap 样 式 的 
label 元 素 和 input 元 系 来 捕获 用 户 输入 。input 元 素 的 
asp-for 属 性 由 内 置 的 标签 助手 处 理 ， 标 签 助手 将 根 
据 指 定 的 模型 属性 生成 type、id、name 和 value 属 
性 ， 如 第 24 章 所 述 





你 可 以 通过 局 动 应 用 程序 ， 单 击 页 面 顶部 的 购 
物 车 图 标 ， 然 后 单 击 Checkout 按 钮 来 查看 操作 方法 
和 视图 的 效果 ， 如 图 10-4 所 示 。 你 也 可 以 通过 请 
求 /CarVCheckout 的 UREL 来 查看 这 个 页 面 。 








Check out now 
Please enter your details, and we'll ship you 


Chess 


Soccer 


Ship to 
Name: 


Address 
Line 1: 


Line 3: 








图 10-4 ”装运 信息 表单 
10.3.3 ”实现 订单 处 理 


可 通过 将 订单 写 入 数据 库 来 处 理 订 单 。 当 然 ， 
大 多 数 电 子 商务 网 站 不 会 向 单 地 如 此 实现 ， 而 且 这 
里 没有 提供 处 理 信 用 卡 或 其 他 付 妹 方式 的 功能 。 但 
是 因为 这 里 想 把 重点 放 在 MVC 上 ， 所 以 一 个 简单 的 
数据 库 条 目 就 可 以 了 。 











1. 扩展 数据 库 








如 果 在 第 8 章 中 创建 的 基本 管道 程序 就 位 了 ， 
就 可 以 将 新 的 模型 添加 到 数据 库 中 。 首 先 ， 癌 数据 
库 上 下 文 类 添加 一 个 新 的 属性 ， 如 代码 清单 10-13 
所 示 。 





代码 清单 10-13 ”在 Models 文 件 夹 下 的 ApplicationDbContext.cs 
文件 中 添加 属性 


using Microsoft.EntityFrameworkCore; 

using Microsoft.EntityFrameworkCore.Design; 

using Microsoft.EntityFrameworkCore. Infrastructure; 
using Microsoft.Extensions.DependencyInjection; 


namespace SportsStore.Models { 


public class ApplicationDbContext : DbContext { 


public ApplicationDbContext (DbContextOptions<Ap 
plicationDbContext> options) 
: base(options) { } 


public DbSet<Product> Products { get; set; } 
public DbSet<Order> Orders { get; set; } 








上 述 更 改 能 够 让 Entity Framework Core 创 建 数 
据 库 迁移 ， 以 将 Order 对 象 存 储 在 数据 库 中 。 要 创 
建 数 据 库 迁 移 ， 请 打开 新 的 命令 提示 符 或 
PowerShell 窗 口 ， 导 航 到 SportsStore 项 目 文件 夹 〈 其 
中 包含 Startup.cs 文 件 ) ， 然 后 运行 以 下 命令 : 


dotnet ef migrations add Orders 


上 述 命令 告诉 Entity Framework Core 获 取 应 用 
程序 数据 模型 的 新 快照 ， 并 对 比 与 以 前 oan 
的 不 同 之 处 ， 生 成 名 为 Orders 的 数据 库 迁 移 。 应 用 
程序 在 局 动 时 将 目 动 应 用 新 mone » KIA 
SeedData 会 调用 Entity Framework Core 提 供 的 
Migrate 方 法 。 


重 置 数据 库 


当 频 繁 更 改 模 型 时 ， 数 据 库 迁 移 和 数据 库 架 构 
不 同步 时 会 出 现 问 题 。 最 人 简 蛙 的 方法 是 删除 数据 库 
并 重新 开始 。 但 是 这 仪 适用 于 开发 期 间 ， 因 为 你 会 
丢失 已 存储 的 任何 数据 。 


要 删除 数据 库 ， 请 在 SportsStore 项 目 文件 夹 中 
运行 以 下 命令 : 


dotnet ef database drop --force 


删除 数据 库 后 ， 从 SportsStore 项 目 文 件 夹 运行 
以 下 命令 以 重新 创建 数据 库 ， 并 通过 运行 以 下 命令 
应 用 创建 的 数据 库 迁 移 


dotnet ef database update 


这 将 重 置 数据 库 ， 以 准确 反映 模型 的 更 改 ， 这 
样 你 就 可 以 继续 开发 应 用 程序 了 。 








2. 创建 订单 存储 库 





下 面 沿用 产品 存储 库 的 模式 ， 以 提供 对 Order 
对 象 的 访问 。 在 Models 文 件 夹 中 添加 一 个 名 为 
IOrderRepository.cs 的 类 文件 ， 并 用 它 定 义 代码 清单 
10-14 所 示 的 接口 。 


代码 清单 10-14 Models 文 件 夹 下 的 IOrderRepository.cs 文 件 的 
内 容 
using System.Ling; 


namespace SportsStore.Models { 


public interface IOrderRepository { 


IQueryable<Order> Orders { get; } 
void SaveOrder(Order order) ; 


} 





} 





为 了 实现 订单 存储 库 接口 ， 将 一 个 名 为 
EFOrderRepository.cs 的 类 文件 添加 到 Models 文 件 夹 
中 ， 并 定义 代码 清单 10-15 所 示 的 类 。 


代码 清单 10-15 Models 文 件 夹 下 的 EFOrderRepository.cs 文 件 
的 内 容 


using Microsoft.EntityFrameworkCore; 
using System.Ling; 


namespace SportsStore.Models { 


public class EFOrderRepository : IOrderRepository { 
private ApplicationDbContext context; 


public EFOrderRepository(ApplicationDbContext c 
tx) { 


context = ctx; 


} 


public IQueryable<Order> Orders => context.Orde 


.Include(o => o.Lines) 
.ThenInclude(1 => 1.Product 


public void SaveOrder(Order order) { 
context .AttachRange(order.Lines.Select(1 => 
1.Product)); 
if (order.OrderID == @) { 
context.Orders.Add(order) ; 


} 


context .SaveChanges() ; 





这 个 类 使 用 Entity Framework Core 实 现 了 
IOrderRepository， 从 而 能 够 检索 已 存储 的 Order 对 
象 集 ， 并 允许 创建 或 更 改 订单 。 


了 解 订单 存储 库 





为 代码 清单 10-15 中 的 订单 实现 存储 库 需 要 做 
一 些 额外 的 工作 。Entity Framework Core 需 要 指令 
来 加 载 相 关 数 据 《〈 如 末路 越 多 个 表 的 话 ) 。 在 代码 
中 ， 使 用 Include 和 ThenInclude 方 法 指定 从 数据 库 中 
读 取 Order 对 象 时 ， 还 应 该 一 起 加 载 与 Lines 属 性 关 
联 的 集合 以 及 与 每 个 集合 对 象 基 联 的 Product 对 象 。 


public IQueryable<Order> Orders => context.Orders 


.Include(o => o.Lines) 
.ThenInclude(1 => 1.Product) ; 





这 将 确保 收 到 所 需 的 所 有 数据 对 象 ， 而 无 须 执 
行 得 询 和 重新 组 狠 数据 。 





当 在 数据 库 中 存储 Order 对 象 时 ， 还 需要 执行 
一 个 额外 的 步骤 。 当 从 会 话 存储 中 反 序 列 化 用 户 的 
购物 车 数据 时 ，JSON 包 会 创建 Entity Framework 
Core 不 知道 的 新 对 象 ， RAW ia 与 入 数 
据 库 。 对 于 Product 对 象 ， 这 总 emi 
Framework Core 答 试 写 入 已 存储 的 对 象 ， 这 会 导致 
错误 。 为 了 避免 这 个 问题 ， ern 
Framework Core 对 象 已 存在 ， 除 非 它们 被 修改 ， 否 
则 不 应 该 存储 在 数据 库 中 ， 如 下 所 示 : 








context .AttachRange(order.Lines.Select(1 => 1.Product)) 





这 可 确保 Entity Framework Core 不 会 尝试 写 入 
与 Order 对 象 关 联 的 反 序列 化 后 的 Product 对 和 象 。 


在 代码 清单 10-16 中 ， 我 们 已 在 Startup 类 的 
ConfigureServices 方 法 中 将 订单 存储 库 注 册 为 服 


务 。 





代码 清单 10-16 在 SportsStore 文 件 夹 下 的 Startup.cs 文 件 中 注册 
Order 存 储 库 服务 








public void ConfigureServices(IServiceCollection servic 
es) { 
services.AddDbContext<ApplicationDbContext> (options 
=> 


options.UseSqlServer ( 
Configuration[ "Data:SportStoreProducts:Conn 
ectionString"])); 
services.AddTransient<IProductRepository, EFProduct 
Repository>(); 
services.AddScoped<Cart>(sp => SessionCart.GetCart( 
sp)); 
services.AddSingleton<IHttpContextAccessor, HttpCon 
textAccessor>(); 
services .AddTransient<IOrderRepository, EFOrderRepo 
sitory>(); 
services.AddMvc(); 
services.AddMemoryCache() ; 
services.AddSession(); 


10.3.4 完成 Order 控 制 器 


为 了 完成 OrderController 类 ， 还 需要 修改 构造 
函数 ， 以 便 接 收 处 理 订 单 押 需 的 服务 ， 并 且 需 要 诡 
加 一 个 新 的 操作 方法 。 当 用 户 单 击 Complete Order 
按钮 时 ， 这 个 操作 方法 将 处 理 HITP 表 单 的 POST 请 
求 。 代 码 清单 10-17 显 示 了 这 两 处 更 改 。 





代码 清单 10-17 在 Controllers 文 件 夹 下 的 OrderController.cs 文 
件 中 完成 Order 控 制 器 





using Microsoft.AspNetCore.Mvc; 
uSing SportsStore.Models; 
using System.Ling; 


namespace SportsStore.Controllers { 


public class OrderController : Controller { 
private IOrderRepository repository; 
private Cart cart; 


public OrderController(IOrderRepository repoSer 
vice, Cart cartService) { 
repository = repoService; 


cart = cartService; 


} 


public ViewResult Checkout() => View(new Order( 


DE 


[HttpPost] 
public IActionResult Checkout(Order order) { 
if (cart.Lines.Count() == 0) { 
ModelState.AddModelError("", "Sorry, yo 
ur cart is empty!"); 


if (ModelState.IsValid) { 
order.Lines = cart.Lines.ToArray(); 
repository.SaveOrder (order) ; 
return RedirectToAction(nameof (Complete 


d)); 
} else { 
return View(order); 
} 
} 
public ViewResult Completed() { 
cart.Clear(); 


return View(); 








Checkout 操 作 方 法 使 用 HttpPost 特 性 进行 修 
饰 ， 这 意味 着 仅 为 POST 请 求 调用 这 个 操作 方法 。 
在 本 例 中 ， 也 就 是 当 用 户 提 区 表单 时 。 再 次 使 用 模 





型 绑 定 系统 以 接收 Order 对 象 ， 然 后 处 理 Cart 中 的 数 
据 并 存储 在 存储 库 中 。 


MVC 使 用 数据 注解 属性 检查 应 用 于 Order 类 的 
验证 约束 ， 并 且 任 何 验证 相关 的 问题 都 会 通过 
ModelState 属 性 传递 给 操作 方法 。 可 以 通过 检查 
ModelState.IsValid 属 性 来 伍 看 是 否 存 在 问题 。 如 果 
购物 车 中 没有 商品 ， 就 调用 
ModelState.AddModelError 方 法 来 注册 错误 消息 。 

稍 后 会 解释 如 何 显示 此 类 错误 ， 第 27 音 和 第 28 章 将 
介绍 更 多 关于 模型 绑 定 和 验证 的 内 容 。 





mel 








单元 测试 


为 了 对 OrderController 类 执行 单元 测试 ， 需 要 
测试 Checkout 方 法 的 POST 请 求 的 行为 。 尽 管 
Checkonut 方 法 看 起 来 很 简单 ， 全 Ge JBBTE 


意味 看 对 测试 来 说 还 有 很 多 事情 要 做 。 





我 们 想 仅 在 购物 车 中 有 商品 并 且 各 户 提 供 有 交 
的 装运 信息 时 处 理 订 单 ， 而 在 其 他 情况 下 应 同 客 户 
显示 错误 。 在 SportsStore.Test 项 目 中 ， 在 名 为 
OrderControllerTests.cs 的 类 文件 中 定义 第 一 个 测试 
Dies 








using Microsoft.AspNetCore.Mvc; 
using Mog; 

using SportsStore.Controllers; 
using SportsStore.Models; 

using Xunit; 


namespace SportsStore.Tests { 
public class OrderControllerTests { 


[Fact ] 
public void Cannot_Checkout_Empty_Cart() { 
// Arrange - create a mock repository 
Mock<IOrderRepository> mock = new Mock<IOrd 
erRepository>(); 
// Arrange - create an empty cart 
Cart cart = new Cart(); 
// Arrange - create the order 
Order order = new Order(); 
// Arrange - create an instance of the cont 


roller 
OrderController target = new OrderControlle 
r(mock.Object, cart); 


// Act 
ViewResult result = target.Checkout(order) 
as ViewResult; 


// Assert - check that the order hasn't bee 
n stored 

mock.Verify(m => m.SaveOrder(It.IsAny<Order 
>()), Times.Never) ; 

// Assert - check that the method is return 
ing the default view 

Assert. True(string.IsNull0rEmpty(result.Vie 
wName) ) ; 

// Assert - check that I am passing an inva 
lid model to the view 

Assert.False(result.ViewData.ModelState.IsV 
alid); 

上 


} 








以 上 测试 可 确保 在 购物 车 为 空 时 不 能 结账 。 可 
通过 确保 不 调用 Pa 的 
SaveOrder 方 法 来 检查 这 一 点 ， 讼 方法 返回 的 是 默认 
视图 〈 它 将 重新 显示 客户 输入 的 数据 并 给 他 们 提供 
纠正 的 机 会 ) ， 并 且 传 递 给 视图 的 模型 状态 已 被 标 





记 为 无 效 。 这 可 能 看 起 来 像 是 万 无 一 失 的 断言 ， 但 
需要 确认 3 个 部 分 以 确保 得 到 正确 的 结果 。 下 一 个 
测试 方法 的 工作 方式 大 致 相同 ， 但 在 视图 模型 中 会 
注入 错误 ， 以 模拟 模型 绑 定 画报 告 的 问题 〈 当 客户 
输入 无 效 的 沪 运 数据 时 会 出 现 ): 





[Fact] 
public void Cannot_Checkout_Invalid_ShippingDetails() { 


// Arrange - create a mock order repository 

Mock<IOrderRepository> mock = new Mock<IOrderReposi 
tory>(); 

// Arrange - create a cart with one item 

Cart cart = new Cart(); 

cart.AddItem(new Product(), 1); 

// Arrange - create an instance of the controller 

OrderController target = new OrderController(mock.O 
bject, cart); 

// Arrange - add an error to the model 

target .ModelState.AddModelError("error", "error"); 


// Act - try to checkout 
ViewResult result = target.Checkout(new Order()) as 
ViewResult; 


// Assert - check that the order hasn't been passed 
stored 
mock.Verify(m => m.SaveOrder(It.IsAny<Order>()), Ti 
mes.Never) ; 


// Assert - check that the method is returning the 
default view 

Assert. True(string.IsNullOrEmpty(result. ViewName) ) ; 

// Assert - check that I am passing an invalid mode 
1 to the view 

Assert.False(result.ViewData.ModelState. IsValid) ; 


} 








除 确保 空 的 购物 车 或 无 效 的 装运 信息 能 阻止 继 
续 处 理 订 单 之 外 ， 还 需要 确保 在 适当 的 时 候 处 理 订 
单 。 测 试 如 下 : 





[Fact] 
public void Can_Checkout_And_Submit_Order() { 
// Arrange - create a mock order repository 
Mock<IOrderRepository> mock = new Mock<IOrderReposi 
tory>(); 
// Arrange - create a cart with one item 
Cart cart = new Cart(); 
cart.AddItem(new Product(), 1); 
// Arrange - create an instance of the controller 
OrderController target = new OrderController(mock.O 
bject, cart); 


// Act - try to checkout 
RedirectToActionResult result = 
target.Checkout(new Order()) as RedirectToActio 
nResult; 


// Assert - check that the order has been stored 

mock.Verify(m => m.SaveOrder(It.IsAny<Order>()), Ti 
mes .Once); 

// Assert - check that the method is redirecting to 
the Completed action 

Assert.Equal("Completed", result.ActionName) ; 
} 





不 需要 测试 那些 可 以 识别 的 有 效 的 装运 细节 。 
这 是 由 模型 绑 定 器 自动 处 理 的 ， 可 通过 在 Order 类 
的 属性 上 应 用 属性 注释 来 实现 。 


10.3.5 ”显示 验证 错误 





MVC 将 使 用 应 用 于 Order 类 的 验证 属性 来 验证 
用 户 数据 。 但 是 ， 还 需要 进行 简单 的 更 改 以 显示 所 
有 问题 。 这 依赖 男 一 个 内 置 的 标签 助手 ， 它 检查 用 
户 提 供 的 数据 的 验证 状态 ， 并 为 已 发 现 的 每 个 问题 
添加 警告 消息 。 人 代码 清 单 10-18 显 示 了 一 个 HTML 元 
素 的 附加 部 分 ， 该 HTML 元 素 将 由 标签 助手 在 





Checkout.cshtml 文 件 中 处 理 。 


代码 清单 10-18 ”将 验证 摘要 添加 到 Views/Order 文 件 夹 下 的 
Checkout.cshtml 文 件 中 


@model Order 


<h2>Check out now</h2> 
<p>Please enter your details, and we'll ship your goods 
right away!</p> 


<div asp-validation-summary="All1" class="text-danger">< 
/div> 


<form asp-action="Checkout" method="post"> 
<h3>Ship to</h3> 





ETT EIR tay E AY DAT) A Ser 
HR. BARA BUR, Wte Fll/Order/Checkout URL, 
并 在 不 选择 任何 商品 或 填写 任何 装运 信息 的 情况 下 
答 试 结账 ， 如 图 10-5 所 示 。 生 成 这 些 消息 的 标签 助 
手 是 模型 验证 系统 的 一 部 分 ， 将 在 第 27 草 中 详细 介 


绍 。 


6 


提 ” 示 


用 户 提 交 的 数据 在 验证 之 前 会 被 发 送 到 服务 
器 ， 这 称 为 服务 器 端 验证 ，MVC 对 此 提供 良好 的 支 
持 。 服 务 器 端 验证 的 问题 是 ， 在 将 数据 发 送 到 服务 
器 并 进行 处 理 以 生成 结果 页 面 之 前 ， 不 会 回 用户 显 
示 错 误 一 一 在 繁忙 的 服务 器 上 有 时 可 能 需要 几 秒 的 
时 间 。 因 些 ， 服 务 器 端 验证 通常 需要 补充 使 用 客户 
器 验证 ， 在 将 表单 数据 发 送 到 服务 器 之 前 ， 使 用 
JavaScript 检 查 用 户 输入 的 值 。 第 27 章 将 摘 述 客户 端 
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图 10-5 “显示 验证 消息 


10.3.6 ”显示 摘要 页 面 
为 了 完成 结账 流程 ， 需 要 创建 一 个 视图 ， 在 浏 
Wa as E FE [5] 21) Order #2 till 4s E A Completed action 时 


显示 。 在 Views/Order 文 件 夹 中 添加 一 个 名 为 
Completed.cshtml 的 Razor 视 图 文件 ， 并 在 其 中 添加 


代码 清单 10-19 所 示 的 代码 。 


代码 清单 10-19 ”Views/Order 文 件 夹 下 的 Completed.cshtml 文 件 
的 内 容 


<h2>Thanks!</h2> 
<p>Thanks for placing your order.</p> 


<p>We'll ship your goods as soon as possible.</p> 


在 将 这 个 视图 集成 到 应 用 程序 时 ， 不 需要 更 改 
任何 代码 ， 因 为 在 定义 Completed 操 作 方 法 时 已 还 
加 必需 的 语句 。 现 在 ， 客 户 可 以 完成 从 选择 商品 到 
结账 的 整个 过 程 。 如 果 提 供 有 效 的 装运 信息 (并 且 
购物 车 中 有 商品 ) ， 在 单 击 Complete Order 按 钮 后 
融会 看 到 摘要 页 面 ， 如 图 10-6 所 示 。 








SPORTS STORE 


Home Thanks! 
= Thanks for placing your order 
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图 10-6 ”已 完成 的 订单 摘要 页 面 
10.4 小结 


本 章 介 绍 了 如 何 实现 SportsStore 应 用 程序 面 加 
容 户 的 所 有 主要 功能 。 这 里 已 经 有 了 商品 目录 ， 可 








以 按 基 列 和 页 面 浏 抠 ， 还 提供 了 简洁 的 购物 车 和 方 
便 的 结账 流程 。 


分 层 民 好 的 架构 意味 着 可 以 轻松 地 更 改 应 用 程 

序 的 任何 部 分 ， 而 不 用 担心 在 其 他 地 方 导致 问题 或 

不 一 致 。 例 如 ， 可 以 更 改 订单 的 存储 方式 ， 而 不 会 

对 购物 车 、 疝 品目 录 或 应 用 程序 的 任何 其 他 部 分 产 

影 啊 。 在 下 一 章 中 ， 将 添加 管理 SportsStore 应 用 
程序 所 需 的 功能 。 

















第 11 章 ”SportsStore 的 管理 


绍 如 何 构 建 SportsStore 应 用 程 
员 提 供 管理 订单 和 商品 的 功能 





11.1 管理 订单 


在 上 一 章 中 ， 添 加 了 接收 客户 订单 并 将 其 存储 
在 数据 库 中 的 功能 。 在 本 章 中 ， 将 创建 一 个 简单 的 
常理 工具 ， 用 于 碍 看 已 收 到 的 订单 并 将 其 标记 为 己 


> te 
Dio 





11.1.1 增强 模型 


要 做 的 第 一 个 更 改 是 增强 模型 ， 用 来 记录 已 
发 货 的 订单 。 代 码 清 单 11-1 在 Order 类 中 添加 了 一 个 
新 的 属性 ，Order 类 定义 在 Models 文 件 夹 下 的 








Order.cs 文 件 中 。 


代码 清单 11-1 在 Models 文 件 夹 下 的 Order.cs 文 件 中 添加 一 个 
新 的 属性 





using System.Collections.Generic; 
using System.ComponentModel.DataAnnotations; 
using Microsoft.AspNetCore.Mvc.ModelBinding; 


namespace SportsStore.Models { 


public class Order { 


[BindNever ] 

public int OrderID { get; set; } 

[ BindNever | 

public ICollection<CartLine> Lines { get; set; 
} 

[BindNever ] 

public bool Shipped { get; set; } 

[Required(ErrorMessage = "Please enter a name") 
] 


public string Name { get; set; } 


[Required(ErrorMessage = "Please enter the firs 
t address line") ] 
public string Line1 { get; set; } 


public string Line2 { get; set; } 
public string Line3 { get; set; } 


[Required(ErrorMessage = "Please enter a city n 


ame") ] 
public string City { get; set; } 
[Required(ErrorMessage = "Please enter a state 
name") ] 
public string State { get; set; } 
public string Zip { get; set; } 
[Required(ErrorMessage = "Please enter a countr 
y name") ] 


public string Country { get; set; } 


public bool GiftWrap { get; set; } 





这 种 扩展 和 调整 模型 以 支持 不 同 功能 的 迭代 方 
法 是 MVC 开 发 的 典型 方式 。 理 想 情 况 下 ， 可 以 在 项 
目 开 始 时 完全 定义 模型 类 ， 并 围绕 它们 构建 应 用 程 
序 ， 但 这 只 发 生 在 最 简单 的 项 目 中 。 实 际 上 ， 这 种 
迭代 开发 是 必需 的 ， 因 为 对 需求 的 理解 一 直 在 发 展 
和 演变 。 





Ot 


Entity Framework Core 迁 移 使 这 个 过 程 更 





易 ， 因 为 不 必 通 过 编写 SQL 命令 手动 保持 数据 库 架 
构 与 模型 类 同步 。 要 更 新 数据 库 以 将 Shipped 属 性 添 
加 到 Order 类 ， 请 打开 新 的 命令 提示 符 或 PowerShell 
窗口 ， 导 航 到 SportsStore 项 目 文 件 夹 (包含 
Startup.cs 文 件 的 那个 文件 夹 ) 并 运行 以 下 命令 : 


dotnet ef migrations add ShippedOrders 


当 应 用 程序 启动 并 日 SeedData 类 调用 Entity 
Framework Core 提 供 的 Migrate 方 法 时 ， 将 自动 应 用 


迁移 。 


11.1.2 ”添加 操作 方法 和 视图 





显示 和 更 新 数据 库 中 的 订单 数据 相对 简单 。 代 
码 清单 11-2 在 Order 控 制 右 中 添加 了 两 个 新 的 操作 方 
VF 
代码 清单 11-2 ”在 Controllers 文 件 严 下 的 OrderController.cs 文 件 
中 添加 操作 方法 





using Microsoft.AspNetCore.Mvc; 
using SportsStore.Models; 
using System.Ling; 


namespace SportsStore.Controllers { 


public class OrderController : Controller { 
private IOrderRepository repository; 
private Cart cart; 
public OrderController(IOrderRepository repoSer 
vice, Cart cartService) { 
repository = repoService; 
cart = cartService; 


} 


public ViewResult List() => 
View(repository.Orders.Where(o => !o.Shippe 


d)); 


[HttpPost] 
public IActionResult MarkShipped(int orderID) { 
Order order = repository.Orders 
.FirstOrDefault(o => o.OrderID == order 
ID); 
if (order != null) { 
order.Shipped = true; 
repository.SaveOrder (order) ; 


} 


return RedirectToAction(nameof(List) ); 


} 


public ViewResult Checkout() => View(new Order( 
))3 


[HttpPost | 


public IActionResult Checkout(Order order) { 
if (cart.Lines.Count() == 0) { 
ModelState.AddModelError("", "Sorry, yo 
ur cart is empty!"); 


} 

if (ModelState.IsValid) { 
order.Lines = cart.Lines.ToArray(); 
repository.SaveOrder(order) ; 
return RedirectToAction(nameof (Complete 

d)); 

} else { 
return View(order) ; 

} 

} 


public ViewResult Completed() { 
cart.Clear(); 
return View(); 





List 操 作 方 法 会 选择 存储 库 中 Shipped 属 性 值 为 
false 的 所 有 Order 对 象 ， 并 将 它们 传递 给 默认 视图 。 
这 是 用 于 同 管理 员 显 示 示 发 货 订 单列 表 的 操作 方 
法 。 


MarkShipped 操 作 方 法 将 接收 一 个 POST 请 求 ， 


该 请 求 指 定 了 订单 的 ID， 用 于 从 存储 库 中 找到 相应 
的 Order 对 象 ， 以 便 将 其 Shipped 属 性 设置 为 tue 并 保 
存 。 


为 了 显示 未 发 贷 订单 的 列表 ， 在 Views/Order 文 
件 夹 中 添加 一 个 名 为 List.cshtml 的 Razor 视 图 文件 ， 
并 添加 代码 清单 11-3 所 示 的 代码 。table 元 素 用 于 显 
示 一 些 细节 ， 包 括 已 购买 商品 的 详细 信息 。 








代码 清单 11-3” ”Views/Order 文 件 夹 下 的 List.cshtml 文 件 的 内 容 





@model IEnumerable<Order> 


@{ 
ViewBag.Title = "Orders"; 
Layout = "_AdminLayout" ; 
} 


@if (Model.Count() > @) { 


<table class="table table-bordered table-striped"> 
<tr><th>Name</th><th>Zip</th><th colspan="2">De 
tails</th><th></th></tr> 
@foreach (Order o in Model) { 
<tr> 
<td>@o.Name</td><td>@o.Zip</td><th>Prod 


uct</th><th>Quantity</th> 
<td> 
<form asp-action="MarkShipped" meth 
od="post"> 
<input type="hidden" name="orde 
rId" value="@o.OrderID" /> 
<button type="submit" class="bt 
n btn-sm btn-danger"> 
Ship 
</button> 
</form> 
</td> 
</tr> 
@foreach (CartLine line in o.Lines) { 
<tr> 
<td colspan="2"></td> 
<td>@line.Product.Name</td><td>@lin 
e.Quantity</td> 
<td></td> 
</tr> 
} 


</table> 
} else { 
<div class="text-center">No Unshipped Orders</div> 


} 











每 个 订单 都 会 显示 一 个 Ship 按 钮 ， 用 于 将 表单 
提交 给 MarkShipped 操 作 方 法 。 使 用 Layout 属 性 为 
List 钢 图 指定 不 同 的 布局 ， 以 窗 话 _ViewStart.cshtml 
文件 中 指定 的 布局 。 











要 添加 布局 ， 可 使 用 MVC View Layout Page 模 
板 在 Views/Shared 文 件 夹 中 创建 一 个 名 为 
_AdminLayout. cshtml 的 文件 ， 并 琴 加 代码 清单 11-4 
所 示 的 代码 。 


代码 清单 11-4 Views/Shared 文 件 夹 下 的 _AdminLayout.cshtml 
文件 的 内 容 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 


<link rel="stylesheet" asp-href-include="1ib/bootst 
rap/dist/css/*.min.css" /> 
<title>@ViewBag.Title</title> 


</head> 
<body class="m-1 p-1"> 
<div class="bg-info p-2"><h4>@ViewBag.Title</h4></d 
iv> 
@RenderBody() 
</body> 
</html> 








BAA Ale VA Ee Pa A, ta a oA 
程序 ， 选 择 一 些 商 品 ， 然 后 结账 。 导 航 


到 /Order/List UREL， 你 将 看 到 创建 的 订单 摘要 ， 如 
图 11-1 所 示 。 单 击 Ship 按 钮 ， 数 据 库 将 被 更 新 ， 待 
处 理 的 订单 列表 将 为 空 。 





图 11-1 管理 订单 





yo aie, 
"EE O OR. 


目前 没有 办 法 阻止 客户 请 求 /OrdevList URL 并 
常理 他 们 目 己 的 订单 。 本 书 第 12 章 将 解释 如 何 限制 
对 操作 方法 的 访问 。 


11.2 ”添加 目 孙 管理 


一 般 来 说 ， 在 管理 复杂 的 对 象 集合 时 ， 需 要 问 
用 户 呈 现 两 种 类 型 的 页 面 一 一 列表 页 面 和 编辑 页 
面 ， 如 图 11-2 所 示 。 





Actions 
Edit | Delete 
Edit | Delete 


Edit | Delete 





Add New Item 


图 11-2 商品 目录 的 CRUD UI 草图 


这 些 页 面 允 许 用 户 创建 、 读 取 、 更 新 和 删除 集 
合 中 的 对 象 。 总 的 来 说 ， 这 些 动作 称 为 CRUD。 开 
发 人 员 经 常 需要 实现 CRUD，Visual Studio 脚 手 架 包 
括 使 用 预定 义 操 作 方 法 创建 CRUD 控 制 器 的 场景 
(第 8 章 解 释 了 如 何 启用 Visual Studio 脚 手 架 功 
能 ) 。 但 是 像 所 有 Visual Studio 模 板 一 样 ， 你 最 好 


学 习 如 何 直接 使 用 ASP.NET Core MVC 的 功能 。 


11.2.1 创建 CRUD 控 制 器 





这 里 将 首先 创建 一 个 单独 的 控制 器 来 管理 商品 
目录 。 在 Controllers 文 件 夹 中 添加 一 个 名 为 
AdminController.cs 的 类 文件 ， 并 添加 代码 清单 11-5 
ARAN TRE - 


代码 清单 11-5 “Controllers 文 件 夹 下 的 AdminController.cs 文 件 
的 内 容 





using Microsoft.AspNetCore.Mvc; 
using SportsStore.Models; 


namespace SportsStore.Controllers { 


public class AdminController : Controller { 
private IProductRepository repository; 


public AdminController(IProductRepository repo) 


repository = repo; 


} 


public ViewResult Index() => View(repository.Pr 
oducts); 


pe 
} 

这 个 控制 器 的 构造 函数 声明 了 对 
IProductRepository 接 口 的 依赖 关系 ， 访 接口 将 在 创 
建 实例 时 解析 。 这 个 控制 器 还 定义 了 Index 操 作 方 
法 ， 这 个 操作 方法 会 调用 View 方 法 以 选择 操作 的 默 
认 视 图 ， 将 数据 库 中 的 一 组 产品 作为 视图 模型 传 
Ho 


单元 测试 





Admin 控 制 妖 的 Pdex 操 作 方 法 的 功能 是 正确 返 
回 存 储 库 中 的 Product 对 象 。 你 可 以 创建 模拟 的 存储 
库 实现 ， 并 将 测试 数据 与 操作 方法 返回 的 数据 做 比 
较 以 进行 测试 。 以 下 是 在 SportsStore.UnitTests 项 目 
中 添加 的 一 个 新 的 名 为 AdminControllerTests.cs 的 单 


元 测试 文件 : 





using System.Collections.Generic; 
using System.Ling; 

using Microsoft.AspNetCore.Mvc; 
using Moq; 

using SportsStore.Controllers; 
using SportsStore.Models; 

using Xunit; 


namespace SportsStore.Tests { 
public class AdminControllerTests { 


[Fact ] 
public void Index_Contains All Products() { 
// Arrange - create the mock repository 
Mock<IProductRepository> mock = new Mock<IP 
roductRepository>() ; 
mock.Setup(m => m.Products).Returns(new Pro 


duct[] { 

new Product {ProductID = 1, Name = "P1" 
Jo 

new Product {ProductID = 2, Name = "P2" 
Jo 

new Product {ProductID = 3, Name = "P3" 
Jo 


}.AsQueryable<Product>()); 
// Arrange - create a controller 
AdminController target = new AdminControlle 


r(mock.Object) ; 


// Action 


Product[] result 
= GetViewModel<IEnumerable<Product>>(ta 
rget.Index())?.ToArray(); 


// Assert 

Assert.Equal(3, result.Length) ; 
Assert.Equal("P1", result[@].Name) ; 
Assert.Equal("P2", result[1].Name) ; 
Assert.Equal("P3", result[2].Name) ; 


} 


private T GetViewModel<T>(IActionResult result) 


where T : class { 
return (result as ViewResult) ?.ViewData.Mod 


el as T; 


} 


} 





在 测试 中 添加 GetViewModel 方 法 ， 以 解析 操作 
方法 的 结果 并 获取 视图 模型 数据 。 稍 后 将 深 加 更 多 
测试 。 


11.2.2 ”实现 列表 视图 


下 一 步 是 为 Admin 控 制 器 的 Index 操 作 方 法 添加 


视图 。 创 建 Views/Admin 文 件 夹 并 在 其 中 添加 一 个 
名 为 Index.cshtm1 的 Razor 文 件 ， 其 内 容 如 代码 清单 
11-6 所 示 。 


代码 清单 11-6 ”Views/Admin 文 件 夹 下 的 Index.cshtml 文 件 的 内 


IP 


谷 





@model IEnumerable<Product> 


@{ 
ViewBag.Title = “All Products"; 
Layout = "_AdminLayout"; 

} 


<table class="table table-striped table-bordered table- 
sm" > 
<tr> 
<th class="text-right">ID</th> 
<th>Name</th> 
<th class="text-right">Price</th> 
<th class="text-center">Actions</th> 
</tr> 
@foreach (var item in Model) { 
<tr> 
<td class="text-right">@item.ProductID</td> 
<td>@item.Name</td> 
<td class="text-right">@item. Price. ToString 
("c")</td> 
<td class="text-center"> 
<form asp-action="Delete" method="post" 


> 
<a asp-action="Edit" class="btn btn 
-sm btn-warning" 
asp-route-productId="@item. Produ 
ctID"> 
Edit 
</a> 
<input type="hidden" name="ProductI 
D" value="@item.ProductID" /> 
<button type="submit" class="btn bt 
n-danger btn-sm"> 
Delete 
</button> 
</form> 
</td> 
</tr> 


} 
</table> 
<div class="text-center"> 
<a asp-action="Create" class="btn btn-primary">Add 
Product</a> 
</div> 








列表 视图 包含 一 个 表格 ， 其 中 每 个 商品 占据 一 
行 ， 包 含 商 品名 称 、 价 格 和 两 个 按钮 ， 这 两 个 按钮 
将 能 够 同 Edit 和 Delete 操 作用 送 请 求 来 编辑 或 删除 丙 
品 。 除 表格 之 外 ， 还 有 以 Create 操 作为 目标 的 Add 
Product 按 钮 。 后 面 还 将 添加 Edit、Delete 和 Create 操 
作 ， 可 以 通过 局 动 应 用 程序 并 请 求 /Admin/Index 


URL 来 码 看 了 商品 的 显示 方式 ， 如 图 11-3 所 示 。 





D All Products 
< C | @ locathost:50000/Admin/index wo: 
ID Name Price Actions 


1 Kayak $275.00 | Bait | Delete | 
2 Lifejacket $48.95 
3 Soccer Ball $19.50 Bg 
4 Comer Flags $34.95 oga 
5 Stadium $79,500.00 | £ar] 
6 Thinking Cap $16.00 ait | Es 
7 Unsteady Chair $29.95 | Ean | ca 
8 Human Chess Board $75.00 | Deiete | 
9 Bling-Bling King $1,200.00 Boga 








图 11-3 ”显示 商品 列表 


2 


fie 示 


Edit 按 钮 位 于 代码 清单 11-6 中 form 元 素 的 内 
部 ， 因 此 Edit 和 Delete 按 钮 彼此 相 邻 ， 间 距 由 


Bootstrap j€- Editi% IA) Wk 4 AIAHTTP GET 
请 求 以 获取 商品 的 当前 详细 信息 ， 这 并 不 需要 form 
元 素 。 但 是 ， 由 于 Delete 按 钮 将 更 改 应 用 程序 状 

态 ， 需 要 使 用 HTTP POST 请 求 ， 因 此 必须 使 用 form 





11.2.3 ”编辑 商品 


为 了 提供 创建 和 更 新 功能 ， 添 加 图 11-2 所 示 的 
商品 编辑 页 面 。 这 项 工作 包括 两 部 分 : 
。 显 示 一 个 允许 演 理 员 更 改 商 品 属性 值 的 页 面 。 
© 请 加 一 个 可 以 在 提交 时 处 理 这 些 更 改 的 操作 方 
VF 0 
1. 创建 Edit 操 作 方法 


代码 清单 11-7 旺 示 了 添加 到 Admin 控 制 右 的 


Edit 操 作 方 法 ， 当 用 户 单 击 Edit 按 钮 时 ， 它 将 接收 
浏览 器 发 送 的 HTTP 请 求 。 


代码 清单 11-7 在 Controllers 文 件 夹 下 的 AdminController.cs 文 
件 中 添加 Edit 操 作 方 法 
using Microsoft.AspNetCore.Mvc; 


using SportsStore.Models; 
using System.Lingq; 


namespace SportsStore.Controllers { 


public class AdminController : Controller { 
private IProductRepository repository; 


public AdminController(IProductRepository repo) 


repository = repo; 


} 


public ViewResult Index() => View(repository.Pr 
oducts); 


public ViewResult Edit(int productId) => 
View(repository.Products 
.FirstOrDefault(p => p.ProductID == pro 


ductId)); 
} 


} 





这 个 简单 的 方法 会 查找 具有 与 productId 参 数 对 
应 的 ID 的 了 商品， 并 作为 视图 模型 对 象 传递 给 View 方 
ee 


测试 Edit 操 作 方 法 


我 们 想 在 Edit 操 作 方 法 中 测试 两 个 功能 。 首 
先 ， 当 提供 有 效 的 id 时 ， 能 够 得 到 正确 的 商品 。 其 
次 ， 当 请 求 存 储 库 中 不 存在 的 这 时 ， 不 会 得 到 任何 
商品 。 以 下 是 添加 到 AdminControllerTests.cs 类 文件 
的 测试 方法 : 








[Fact] 
public void Can Edit Product() { 
// Arrange - create the mock repository 
Mock<IProductRepository> mock = new Mock<IProductRe 
pository>(); 
mock.Setup(m => m.Products).Returns(new Product[] { 


new Product {ProductID = 1, Name = "P1"}, 
new Product {ProductID = 2, Name = "P2"}, 
new Product {ProductID = 3, Name = "P3"}, 


}.AsQueryable<Product>()); 

// Arrange - create the controller 

AdminController target = new AdminController(mock.0O 
bject); 


// Act 

Product p1 = GetViewModel<Product>(target.Edit(1)); 
Product p2 = GetViewModel<Product>(target.Edit(2)); 
Product p3 = GetViewModel<Product>(target.Edit(3)); 
// Assert 


Assert.Equal(1, p1.ProductID); 
Assert.Equal(2, p2.ProductID); 
Assert.Equal(3, p3.ProductID); 


} 


[Fact] 
public void Cannot_Edit_Nonexistent_Product() { 
// Arrange - create the mock repository 
Mock<IProductRepository> mock = new Mock<IProductRe 
pository>(); 
mock.Setup(m => m.Products).Returns(new Product[] { 
new Product {ProductID = 1, Name = "P1"}, 
new Product {ProductID = 2, Name = "P2"}, 
new Product {ProductID 3, Name "P3"}, 
}.AsQueryable<Product>()); 


// Arrange - create the controller 
AdminController target = new AdminController(mock.O 
bject); 


// Act 
Product result = GetViewModel<Product>(target.Edit( 


4)); 


// Assert 


Assert.Null(result) ; 
} 


2. 创建 Edit 视 图 


现在 有 了 一 个 操作 方法 ， 可 以 创建 一 个 视图 来 
显示 它 。 在 Views/Admin 文 件 夹 中 添加 一 个 名 为 
Edit.cshtml 的 Razor 视 图 文件 ， 并 添加 代码 清单 11-8 
所 示 的 标记 。 


代码 清单 11-8 ”Views/Admin 文 件 夹 下 的 Edit.cshtml 文 件 的 内 容 





@model Product 
@{ 


ViewBag.Title = "Edit Product"; 
Layout = "_AdminLayout" ; 
} 


<form asp-action="Edit" method="post"> 
<input type="hidden" asp-for="ProductID" /> 
<div class="form-group"> 
<label asp-for="Name"></label> 
<input asp-for="Name" class="form-control" /> 
</div> 


<div class="form-group"> 
<label asp-for="Description"></label> 
<textarea asp-for="Description" class="form-con 
trol"></textarea> 
</div> 
<div class="form-group"> 
<label asp-for="Category"></label> 
<input asp-for="Category" class="form-control" 
/> 
</div> 
<div class="form-group"> 
<label asp-for="Price"></label> 
<input asp-for="Price" class="form-control" /> 
</div> 
<div class="text-center"> 
<button class="btn btn-primary" type="submit">S 
ave</button> 


<a asp-action="Index" class="btn btn-secondary" 
>Cancel</a> 
</div> 
</form> 





Edit 视 图 包含 一 个 HTML 表 单 ， 它 使 用 标签 助 
手 生 成 大 部 分 内 容 ， 包 括 设 置 form 和 a 元 素 的 目 
标 ， 设 置 label 元 素 的 内 容 ， 以 及 为 input 和 textarea 元 
素 生 成 name、id 和 value 属 性 








可 以 通过 局 动 应 用 程序 ， 导 航 到 /Admin/Index 


URL， 然 后 单 击 其 中 一 个 商品 的 Edit 按 钮 来 查看 视 
图 生成 的 HTML， 如 图 11-4 所 示 。 





D Edit Product x 
一 C | O locathost:60000/Admin/Edit?productid=3 wl]? 
Name 

Soccer Ball 
Description 


FIFA-approved size and weight 


Soccer 











图 11-4 显示 商品 的 属性 以 进行 编辑 


q 


je ” 示 


为 了 简单 起 见 ， 为 ProductID 属 性 使 用 隐藏 的 
input 元 素 。 当 Entity Framework Core 存 储 新 对 象 





时 ， 由 数据 库 生成 ProductID 的 值 并 将 其 设置 为 主 
键 ， 安 全 地 更 改 它 可 能 是 一 个 复杂 的 过 程 。 对 于 大 
多 数 应 用 程序 ， 最 简单 的 方法 是 防止 用 户 更 改 值 。 








3. 更 新 Product 存 储 库 


在 处 理 编辑 之 前 ， 还 需要 改进 Product 存 储 库 ， 
以 便 能 够 保存 更 改 。 首 先 ， 疝 IProductRepository 接 
口 添加 一 个 新 的 方法 ， 如 代码 清单 11-9 所 示 。 


代码 清单 11-9 在 Models 文 件 夹 下 的 IProductRepository.cs 文 件 
中 添加 一 个 新 的 方法 





using System.Ling; 


namespace SportsStore.Models { 
public interface IProductRepository { 
IQueryable<Product> Products { get; } 


void SaveProduct(Product product); 


} 
RAR 

然后 ， 可 以 将 这 个 新 方法 添加 到 由 Entity 
Framework Core 实 现 的 存储 库 中 ， 有 具体 定义 在 


EFProductRepository.cs 文 件 中 ， 如 代码 清单 11-10 所 
不 。 











代码 清单 11-10 ”在 Models 文 件 夹 下 的 EFProductRepository.cs 文 
件 中 实现 这 个 新 方法 





using System.Collections.Generic; 
using System.Ling; 


namespace SportsStore.Models { 


public class EFProductRepository : IProductReposito 
ry { 
private ApplicationDbContext context; 


public EFProductRepository(ApplicationDbContext 
ctx) { 


context = ctx; 


} 


public IQueryable<Product> Products => context. 
Products; 


public void SaveProduct(Product product) { 


if (product.ProductID == @) { 
context.Products.Add(product) ; 
} else { 
Product dbEntry = context.Products 
.FirstOrDefault(p => p.ProductID == 
product.ProductID) ; 
if (dbEntry != null) { 
dbEntry.Name = product.Name; 
dbEntry.Description = product.Descr 
iption; 
dbEntry.Price = product.Price; 
dbEntry.Category = product.Category; 


} 


} 


context .SaveChanges(); 





如 果 ProductID 为 0，SaveChanges 操 作 方 法 会 将 
Alm See Ps 人 否则， 就 对 数据 库 中 的 现 有 
了 商品 进行 更 新 。 





本 间 不 会 深入 介绍 Entity Framework Core 的 细 
节 ， 因 为 如 前 所 述 ， 这 本 喘 融 是 一 个 较 大 的 主题 ， 


2. 


而 不 是 ASP.NET Core MVC 的 一 部 分 。 但 是 ， 


SaveProduct 操 作 方 法 中 有 一 些 内 容 与 MVC 应 用 程 
序 的 设计 有 关 。 


当 收 到 ProductID 不 为 0 的 Product 参 数 时 ， 需 要 
执行 更 新 。 可 以 通过 以 下 步骤 来 实现 : 从 存储 库 中 
获取 具有 相同 ProductID 的 Product 对 象 ， 并 更 新 每 个 
属性 ， 使 它们 与 参数 对 象 岂 配 。 





这 样 做 是 因为 Entity Framework Core 会 跟踪 从 
数据 库 创建 的 对 象 。 传 递 给 E 
的 对 象 是 由 MVC 模 型 绑 定 功能 创建 的 ， 这 意味 着 
Entity Framework Core 对 新 的 Product 对 象 一 无 所 
知 ， 在 修改 数据 库 时 不 会 对 数据 库 应 用 更 新 。 有 很 
多 方法 可 以 解决 这 个 问题 ， 这 里 采用 最 人 徐 单 的 方 
法 ， 即 找到 Entity Framework Core 跟 踪 的 相应 对 
象 ， 并 明确 地 更 新 它们 。 


在 IProductRepository 接 口中 添加 新 方法 破坏 了 


己 在 第 8 章 中 创建 的 虚拟 存储 库 类 
FakeProductRepository。 可 使 用 虚拟 存储 库 启 动 开 
发 过 程 ， 并 演示 如 何 使 用 服务 来 无 颖 茶 换 接口 实 
现 ， 而 无 须 修 改 依 赖 它们 的 组 件 。 现 在 不 再 需要 虚 
拟 存 储 库 ， 在 代码 清单 11-11 中 ， 可 以 看 到 已 从 类 
声明 中 删除 了 接口 ， 因 此 不 必 在 添加 存储 库 功 能 时 
继续 修改 该 类 。 





代码 清单 11-11 删除 Models 文 件 夹 下 的 
FakeProductRepository.cs 文 件 中 的 接口 





using System.Collections.Generic; 
using System.Ling; 


namespace SportsStore.Models { 


public class FakeProductRepository /* : IProductRep 
ository */ { 


public IQueryable<Product> Products => new List 
<Product> { 
new Product { Name = "Football", Price = 25 


J 


179 }, 


new Product { Name = "Surf board", Price = 


new Product { Name = "Running shoes", Price 


= 95 } 
}.AsQueryable<Product>() ; 


} 





A. 处 理 编 辑 POST 请 求 


现在 可 以 在 Admin 控 制 器 中 实现 Edit 操 作 方 法 
的 重 载 ， 从 而 在 管理 员 单 击 Save 按 钮 时 处 理 POST 
请 求 。 代 码 清单 11-12 显 示 了 新 的 Edit 操 作 方 法 。 


代码 清单 11-12 ”在 Controllers 文 件 夹 下 的 AdminController.cs 文 
件 中 定义 新 的 Edit 操 作 方 法 





using Microsoft.AspNetCore.Mvc; 
using SportsStore.Models; 
using System.Ling; 


namespace SportsStore.Controllers { 


public class AdminController : Controller { 
private IProductRepository repository; 


public AdminController(IProductRepository repo) 


repository = repo; 


public ViewResult Index() => View(repository.Pr 
oducts); 


public ViewResult Edit(int productId) => 
View(repository.Products 
.FirstOrDefault(p => p.ProductID == pro 
ductId) ) ; 


[HttpPost ] 
public IActionResult Edit(Product product) { 
if (ModelState.IsValid) { 
repository.SaveProduct (product) ; 
TempData["message"] = $"{product.Name} 
has been saved"; 
return RedirectToAction("Index" ) ; 
} else { 
// there is something wrong with the da 
ta values 


return View(product) ; 





FY GEL Ey ARAA Ee He LQ 
ModelState.IsSValid 属 性 的 值 来 验证 用 户 提交 的 数 
据 。 如 琳 一 切 正常 ， 就 将 更 改 保存 到 存储 库 并 将 用 
户 重 定 问 到 Index 操 作 方 法 ， 以 便 他 们 看 到 修改 后 的 
商品 列表 。 如 果 数 据 有 问题 ， 会 再 次 演 染 默认 视 

















Al, MENFP HTE Es 





保存 存储 库 中 的 更 改 后 ， 使 用 temp data 功 能 存 
ffi i, temp data 功 能 是 ASP.NET Core 会 话 状态 功 
能 的 一 部 分 。 这 是 键 / 值 字典 ， 类 似 于 之 前 使 用 的 会 
话 数据 和 view bag 功 能 ， 与 会 话 数 据 的 主要 区 别 在 
于 临时 数据 在 读 取 之 前 一 直 存 在 。 








在 这 种 情况 下 不 能 使 用 ViewBag， 因 为 
ViewBag 在 控制 融和 视图 之 间 传 递 数 据 ， 并 且 数 据 
的 保存 时 间 不 能 超过 当前 的 HTTP 请 求 。 编 辑 成 功 
后 ， 浏 览 占 将 重 定 癌 到 新 的 URL， 因 此 ViewBag 数 
据 将 丢失 。 可 以 使 用 会 话 数据 功能 ， 但 是 在 明确 删 
除 之 前 ， 消 息 将 一 十 存 在， 这 里 并 不 想 这 样 做 。 








因此 ，temp data 功 能 是 最 合适 的 。 数 据 仅 限 于 
单个 用 户 的 会 话 〈 因 此 用 户 看 不 到 彼此 的 临时 数 
据 ) 并 且 会 持续 足够 长 的 时 间 以 供用 户 读 取 。 这 里 


将 读 取 香 定 占用 户 的 操作 方法 呈现 的 视图 中 的 数 
据 。 


单元 测试 一 一 编辑 提交 的 数据 





对 于 Edit 操 作 方 法 处 理 POST 请 求 的 过 程 ， 需 要 
确保 将 作为 方法 参数 接收 的 Product 对 象 的 有 效 更 新 
传递 到 Product 存 储 库 以 进行 保存 。 这 里 还 需要 检查 
无 效 更 新 〈 在 模型 验证 错误 的 情况 下 ) 不 会 传递 到 
存储 库 。 以 下 是 添加 到 AdminControllerTests.cs 文 件 
中 的 测试 方法 : 





[Fact] 
public void Can_Save Valid Changes() { 
// Arrange - create mock repository 
Mock<IProductRepository> mock = new Mock<IProductRe 
pository>(); 
// Arrange - create mock temp data 
Mock<ITempDataDictionary> tempData = new Mock<ITemp 
DataDictionary>(); 
// Arrange - create the controller 


AdminController target = new AdminController(mock.O 
bject) { 
TempData = tempData.Object 


}; 
// Arrange - create a product 
Product product = new Product { Name = "Test" }; 


// Act - try to save the product 

TActionResult result = target.Edit(product) ; 

// Assert - check that the repository was called 

mock.Verify(m => m.SaveProduct(product) ) ; 

// Assert - check the result type is a redirection 

Assert. IsType<RedirectToActionResult>(result) ; 

Assert.Equal("Index", (result as RedirectToActionRe 
sult) .ActionName) ; 


} 


[Fact] 
public void Cannot_Save_Invalid_Changes() { 
// Arrange - create mock repository 
Mock<IProductRepository> mock = new Mock<IProductRe 
pository>(); 
// Arrange - create the controller 
AdminController target = new AdminController(mock.O 


bject); 
// Arrange - create a product 
Product product = new Product { Name = "Test" }; 


// Arrange - add an error to the model state 
target .ModelState.AddModelError("error", "error"); 


// Act - try to save the product 

TActionResult result = target.Edit(product) ; 

// Assert - check that the repository was not calle 
d 

mock.Verify(m => m.SaveProduct(It.IsAny<Product>() ) 
» Times.Never()); 


// Assert - check the method result type 
Assert.IsType<ViewResult>(result) ; 


5. T AN AAU E 








在 _AdminLayout.cshtml 布 局 文件 中 处 理 使 用 
TempData 和 存储 的 消 晨 ， 如 代码 清单 11-13 所 示 。 通 
过 处 理 檬 板 中 的 消 奶 ， 可 以 在 任何 使 用 模板 的 视图 
中 创建 消息 ， 而 无 须 创 建 其 他 Razor 表 达 式 。 





代码 清单 11-13 ”处 理 _AdminLayout.cshtml 文 件 中 的 ViewBag 消 
= 


JÒ 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 
<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 


<title>@ViewBag.Title</title> 
</head> 
<body class="m-1 p-1"> 

<div class="bg-info p-2"><h4>@ViewBag. Title</h4></d 
iv> 

@if (TempData["message"] != null) { 

<div class="alert alert-success">@TempData[ "mes 

sage" ]</div> 


@RenderBody( ) 
</body> 
</html> 





人 
提示 


在 模板 中 处 理 消息 的 好 处 是 ， 在 保存 所 做 更 改 
后 的 所 有 页 面 上 ， 用 户 都 能 看 到 它们 。 目 前 ， 将 它 
们 返回 商品 列表 中 ， 但 可 以 更 改 工 作 流 以 呈现 其 他 
视图 ， 用 户 仍 将 看 到 消 明 〈 只 要 下 一 个 视图 也 使 用 
相同 的 布局 ) 。 


现在 已 经 准备 好 用 于 编辑 商品 的 所 有 代码 。 要 
丛 看 具体 是 如 何 工 作 的 ， 请 局 动 应 用 程序 ， 导 航 
到 /Admin/Index URL， 单 击 Edit 按 钮 ， 然 后 进行 更 
改 。 单 击 Save 按 钮 ， 你 将 被 重 定 同 到 /Admin/Index 
URL， 并 显示 TempData 消 轧 ， 如 图 11-5 所 示 。 











图 11-5 ”编辑 商品 并 得 看 TempData 消 县 


如 果 重 新 加 载 商 品 列 表 视 图 ， 消 息 将 消失 ， 
为 TempData 在 谈 取 时 会 被 删除 。 这 很 方便 ， 因 为 作 
者 不 和 希望 一 直 显 示 旧 的 信息 。 


6. 添加 模型 验证 





接 下 来 需要 问 模 型 类 添加 验证 规则 。 目 前 ， 管 
理 员 可 以 输入 负 的 价格 或 空白 描述 ，SportsStore 应 
用 程序 会 很 乐意 将 这 些 数据 存储 在 数据 库 中 。 坏 数 
据 是 否 会 成 功 你 留 将 取决 于 它们 是 否 符合 Entity 
Framework Core 创 建 的 SQL 表 中 的 约束 ， 这 对 于 大 
多 数 应 用 程序 来 说 保护 得 还 不 够 。 为 了 防止 错误 的 
数据 值 ， 使 用 特性 修饰 Product 类 的 属性 ， 如 代码 清 
单 11-14 所 示 ， 就 像 在 第 10 章 中 对 Order 类 所 做 的 那 
样 。 
代码 清单 11-14 在 Models 文 件 夹 下 的 Productcs 文 件 中 应 用 验 
证 特性 





using System.ComponentModel .DataAnnotations; 
using Microsoft.AspNetCore.Mvc.ModelBinding; 


namespace SportsStore.Models { 


public class Product { 
public int ProductID { get; set; } 


[Required(ErrorMessage = "Please enter a produc 
t name") ] 
public string Name { get; set; } 


[Required(ErrorMessage = "Please enter a descri 
ption") ] 
public string Description { get; set; } 


[Required ] 
[Range(@.@1, double.MaxValue, 
ErrorMessage = "Please enter a positive pri 


ce") ] 


public decimal Price { get; set; } 


[Required(ErrorMessage = "Please specify a cate 


gory") ] 


} 


public string Category { get; set; } 














第 10 章 使 用 标签 助手 在 表单 顶部 显示 验证 错误 
的 摘要 。 在 本 例 中 ， 将 使 用 类 似 的 方法 ， 但 是 将 在 
Edit 视 图 中 的 各 个 表单 元 又 劳 显 示 错 误 消 已 ， 如 代 
码 清单 11-15 所 示 。 








代码 清单 11-15 “在 Views/Admin 文 件 夹 下 的 Edit.cshtml 文 件 中 
添加 验证 错误 元 素 


@model Product 





@{ 
ViewBag.Title = "Edit Product"; 


Layout = "_AdminLayout"; 
} 


<form asp-action="Edit" method="post"> 
<input type="hidden" asp-for="ProductID" /> 
<div class="form-group"> 
<label asp-for="Name"></label> 
<div><span asp-validation-for="Name" class="tex 
t-danger"></span></div> 
<input asp-for="Name" class="form-control" /> 
</div> 
<div class="form-group"> 
<label asp-for="Description"></label> 
<div><span asp-validation-for="Description" cla 
ss="text-danger"></span></div> 
<textarea asp-for="Description" class="form-con 
trol"></textarea> 
</div> 
<div class="form-group"> 
<label asp-for="Category"></label> 
<div><span asp-validation-for="Category' 
"text-danger"></span></div> 
<input asp-for="Category" class="form-control" 


class= 


/> 
</div> 
<div class="form-group"> 
<label asp-for="Price"></label> 
<div><span asp-validation-for="Price" class="te 
xt-danger"></span></div> 
<input asp-for="Price" class="form-control" /> 
</div> 
<div class="text-center"> 
<button class="btn btn-primary" type="submit">S 
ave</button> 


<a asp-action="Index" class="btn btn-secondary" 
>Cancel</a> 
</div> 
</form> 








“4M ARF spanzc# iy}, ANasp-validation-for}& tt 
应 用 标签 助手 ， 从 而 当 存 在 任何 验证 问题 时 ， 为 指 
定 的 属性 添加 验证 错误 消 居 。 





标签 助手 将 问 span 元 条 插入 一 条 错误 消 忌 ， 并 

癌 Span 元 素 谎 加 input-validation-error 类 ， 这 样 可 以 

很 容易 地 将 CSS 样 式 应 用 于 错误 消息 元 素 ， 如 代码 
清单 11-16 所 示 。 


代码 清单 11-16 ”将 CSS 添 加 到 Views/Shared 文 件 夹 下 的 
_AdminLayout.cshtml 文 件 中 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 
<link rel="stylesheet" asp-href-include="1ib/bootst 
rap/dist/css/*.min.css" /> 
<title>@ViewBag.Title</title> 


<style> 
-input-validation-error { border-color: red; ba 
ckground-color: #fee ; } 
</style> 
</head> 
<body class="m-1 p-1"> 
<div class="bg-info p-2"><h4>@ViewBag.Title</h4></d 
iv> 
@if (TempData["message"] != null) { 
<div class="alert alert-success mt-1">@TempData 
[ "message" |</div> 


} 
@RenderBody() 
</body> 
</html> 





定义 的 CSS 样 式 将 选择 作为 input-validation- 
error 关 成 员 的 元 素 ， 并 应 用 红色 边框 和 背景 两 色 。 








提 示 


在 使 用 Bootstrap 这 样 的 CSS 库 时 ， 显 式 地 设置 


样式 会 在 应 用 内 容 时 导致 主题 不 一 致 。 第 27 章 将 展 
示 一 种 蔡 代 方法 ， 该 方法 使 用 JavaScript 代 人 码 将 
Bootstrap 关 应 用 于 具有 验证 错误 的 元 系 ， 这 虽然 使 
得 所 有 内 容 保持 一 致 ， 但 也 更 复杂 。 





可 以 在 视图 中 的 任何 位 置 应 用 验证 消息 标签 助 
手 ， 但 常规 (并且 合理 的 ) 做 法 是 将 标签 助手 放 在 
问题 元 素 附近 的 某 个 位 置 ， 以 向 用 户 提供 一 些 上 下 
文 信 息 。 图 11-6 显 示 了 验证 消息 和 提示 ， 可 以 通过 
运行 应 用 程序 、 编 辑 商品 和 提交 无 效 数 据 来 查看 这 
些 验 证 消 明 和 提示 。 


7. 司 用 客户 站 验证 


目前 ， 仅 当 管 理 员 用 户 同 服务 硕 提 交 编 辑 时 才 
应 用 数据 验证 ， 但 是 大 多 数 用 户 和 希望 如 条 得 入 的 数 


据 存 在 问题 ， 能 够 立即 得 到 有 反馈。 这 就 是 开 友 人 员 
经 香 想 要 执行 客户 端 验证 的 原因 ， 即 使 用 JavaScript 
在 浏览 器 中 检查 数据 。MVC 应 用 程序 可 以 基于 应 用 
于 域 模型 类 的 数据 注解 来 执行 客户 端 验证 。 


第 一 步 古 同 应 用 程序 添加 提供 客户 端 功能 的 
JavaScript 库 ， 这 在 bower.json 文 件 中 完成 ， 如 代码 
清单 11-17 所 示 。 









































图 11-6 ”编辑 商品 时 执行 数据 验证 


代码 清单 11-17 “在 bower.json 文 件 中 添加 JavaScript 包 


"name": "asp.net", 

"private": true, 

"dependencies": { 
"bootstrap": "4. 


©. 
"fontawesome": "4. 
"jquery": "3.2.1", 
"jquery-validation": "1.17.0", 
"jquery-validation-unobtrusive": "3.2.6" 





A 简化 
了 浏览 器 的 DOM API。 下 一 步 是 将 JavaScript 文 件 
添加 到 布局 中 ， 以 便 在 使 用 a 时 
加 载 它 们 ， 如 代码 清单 11-18 所 示 。 





代码 清单 11-18 将 验证 库 添 加 到 Views/Shared 文 件 夹 下 的 
_AdminLayout.cshtml 文 件 中 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 
<link rel="stylesheet" asp-href-include="1ib/bootst 


rap/dist/css/*.min.css" /> 
<title>@ViewBag.Title</title> 
<style> 
.input-validation-error { border-color: red; ba 
ckground-color: #fee ; } 
</style> 
<script src="/1lib/jquery/dist/jquery.min.js"></scri 
pt> 
<script src="/1ib/jquery-validation/dist/jquery.val 
idate.min.js"></script> 
<script 
src="/1ib/jquery-validation-unobtrusive/jquery.va 
lidate.unobtrusive.min.js"> 
</script> 
</head> 
<body class="m-1 p-1"> 
<div class="bg-info p-2"><h4>@ViewBag.Title</h4></d 
iv> 
@if (TempData["message"] != null) { 
<div class="alert alert-success mt-1">@TempData 
[ "message" |</div> 


} 
@RenderBody( ) 
</body> 
</html> 








Jai FAP sin Sor WE AN 2 BU AA] FY A EL, 1E 
是 由 C# 模 型 类 属性 指定 的 约束 将 在 浏览 器 中 强制 执 
行 ， 从 而 阻止 用 户 提交 包含 错误 数据 的 表单 ， 并 在 
有 问题 时 立即 提供 反 饿 。 有 关 详 细 信息 ， 请 参见 第 











27%. 


11.2.4 创建 新 的 商品 


接 下 来 ， 将 实现 Create 操 作 方 法 ， 这 个 操作 方 
法 在 主 了 商品 列表 页 面 中 由 Add Product 链 接 指定 的 。 
这 将 允许 管理 员 将 新 的 商品 添 加 到 商品 目录 中 。 还 
加 创建 新 疝 品 的 功能 需要 对 应 用 程序 进行 一 点 小 的 
更 改 。 这 是 一 个 很 好 的 例子 ， 展 示 了 结构 民 好 的 
MVC 应 用 程序 具有 的 强大 功能 和 灵活 性 。 首 先 ， 将 
Create 操 作 方 法 (如 代码 清单 11-19 所 示 〉 添加 到 
Admin 控 制 器 中 。 




















代码 清单 11-19 ”将 Create 操 作 方 法 添加 到 Controllers 文 件 夹 下 
的 AdminController.cs 文 件 中 





using Microsoft.AspNetCore.Mvc; 
uSing SportsStore.Models; 
using System.Ling; 


namespace SportsStore.Controllers { 


public class AdminController : Controller { 
private IProductRepository repository; 


public AdminController(IProductRepository repo) 


repository = repo; 


} 


public ViewResult Index() => View(repository.Pr 
oducts); 


public ViewResult Edit(int productId) => 
View(repository.Products 
.FirstOrDefault(p => p.ProductID == pro 
ductId) ); 


[HttpPost | 
public IActionResult Edit(Product product) { 
if (ModelState.IsValid) { 
repository.SaveProduct (product) ; 
TempData["message"] = $"{product.Name} 
has been saved"; 
return RedirectToAction("Index" ) ; 
} else { 
// there is something wrong with the da 
ta values 
return View(product) ; 


} 


public ViewResult Create() => View( "Edit", new 
Product()); 


} 


} 





Create 操 作 方 法 不 会 演 染 默认 视图 ， 而 是 指定 
应 使 用 Edit 视 图 。 一 个 操作 方法 完全 可 以 使 用 通 弟 
与 男 一 个 操作 方法 关联 的 视图 。 在 这 种 情况 下 ， 可 
以 提供 一 个 新 的 Product 对 象 作为 视图 模型 ， 以 便 使 
用 空 字 上段 填 元 Edit 视 图 。 


YO 
vy Bats oA 
YE OR 


这 里 没有 为 Create 操 作 方 法 添加 单元 测试 。 这 
样 做 只 会 测试 ASP.NET Core MVC 处 理 来 自 操作 方 
法 的 结果 的 能 力 ， 这 是 理所当然 的 〈 除 非 怀疑 存在 
缺陷 ， 盏 则 通常 不 会 为 框架 功能 编写 测试 〉。 





这 是 唯一 需要 执行 的 更 改 ， 因 为 Edit 操 作 方 法 
己 设 置 为 从 模型 绑 定 系统 接收 Product 对 象 并 将 它们 
存储 在 数据 库 中 。 可 以 通过 局 动 应 用 程序 ， 导 航 
到 /Admin/Index， 单 击 Add Product 按 钮 ， 然 后 填充 
并 提交 表单 来 测试 此 功能 。 你 在 表单 中 指定 的 详细 
言 轧 将 用 于 在 数据 库 中 创建 新 的 商品 ， 然 后 新 的 商 
品 将 显示 在 列表 中 ， 如 图 11-7 所 示 。 











图 11-7 ”将 新 的 商品 添加 到 目录 中 


11.25 删除 商品 


添加 删除 商品 的 功能 也 很 简单 。 第 一 步 是 回 
IProductRepository 接 口 添 加 一 个 新 的 方法 ， 如 代码 
清单 11-20 所 示 。 


代码 清单 11-20 ”在 Models 文 件 夹 下 的 IProductRepository.cs 文 
件 中 添加 商品 删除 方法 
using System.Ling; 
namespace SportsStore.Models { 
public interface IProductRepository { 
IQueryable<Product> Products { get; } 


void SaveProduct(Product product) ; 


Product DeleteProduct(int productID) ; 








接 下 来 ， 在 Entity Framework Core 存 储 库 类 
EFProductRepository 中 实现 这 个 方法 ， 如 代码 清单 
11-21 所 示 。 





代码 清单 11-21 ”在 Models 文 件 夹 下 的 EFProductRepository.cs 文 


件 中 实现 商品 删除 功能 





using System.Collections.Generic; 
using System.Ling; 


namespace SportsStore.Models { 


public class EFProductRepository : IProductReposito 


ry { 
private ApplicationDbContext context; 


public EFProductRepository(ApplicationDbContext 
ctx) { 
context = ctx; 


} 


public IQueryable<Product> Products => context. 
Products; 


public void SaveProduct(Product product) { 
if (product.ProductID == @) { 
context.Products.Add(product) ; 
} else { 
Product dbEntry = context.Products 
.FirstOrDefault(p => p.ProductID == 
product.ProductID) ; 
if (dbEntry != null) { 
dbEntry.Name = product.Name; 
dbEntry.Description = product.Descr 
iption; 
dbEntry.Price = product.Price; 
dbEntry.Category = product.Category 


Context .SaveChanges() ; 


} 
public Product DeleteProduct(int productID) { 
Product dbEntry = context.Products 
.FirstOrDefault(p => p.ProductID == pro 
ductID) ; 
if (dbEntry != null) { 
context.Products.Remove(dbEntry) ; 
context.SaveChanges() ; 


return dbEntry; 





Bn 22 xe TE Admin hae P SCH Delete BEE 
方法 。 这 个 操作 方法 应 仅 文 持 POST 请 求 ， 因 为 删 
除 对 象 不 是 惨 等 操作 。 正 如 在 第 16 章 中 解释 的 那 
样 ， 浏 览 絮 和 缓存 可 以 在 未 经 用 户 明 确 同 童 的 情况 
下 自由 发 出 GET 请 求 ， 因 此 必须 小 心 避免 因 GET 请 
求 而 进行 更 改 的 情况 。 代 码 清 单 11-22 显 示 了 新 的 
Delete 操 作 方 法 。 














代码 清单 11-22” 在 Controllers 文 件 夹 下 的 AdminController.cs 文 
件 中 添加 Delete 操 作 方 法 





using Microsoft.AspNetCore.Mvc; 
using SportsStore.Models; 
using System.Ling; 


namespace SportsStore.Controllers { 


public class AdminController : Controller { 
private IProductRepository repository; 


public AdminController(IProductRepository repo) 


repository = repo; 


} 


public ViewResult Index() => View(repository.Pr 
oducts); 


public ViewResult Edit(int productId) => 
View(repository.Products 
.FirstOrDefault(p => p.ProductID == pro 
ductId) ) ; 


[HttpPost | 
public IActionResult Edit(Product product) { 
if (ModelState.IsValid) { 
repository.SaveProduct (product) ; 
TempData["message"] = $"{product.Name} 
has been saved"; 
return RedirectToAction("Index" ) ; 
} else { 
// there is something wrong with the da 
ta values 
return View(product) ; 


public IActionResult Create() => View("Edit", n 
ew Product()); 


[HttpPost ] 
public IActionResult Delete(int productId) { 
Product deletedProduct = repository.DeleteP 
roduct(productId) ; 
if (deletedProduct != null) { 
TempData["message"] = $"{deletedProduct 
.Name} was deleted"; 


} 


return RedirectToAction("Index") ; 








单元 测试 一 一 删除 商品 


下 面 测试 Delete 操作 方法 的 基本 功能 : 当 把 有 
效 的 ProductID 作为 参数 传递 时 ， 调 用 存储 库 的 
DeleteProduct 方 法 ， 并 传递 正确 的 ProductID 信 进行 
删除 。 下 面 是 添加 到 AdminControllerTests.cs 文 件 的 
训 试 : 


[Fact] 
public void Can_Delete Valid Products() { 

// Arrange - create a Product 

Product prod = new Product { ProductID = 2, Name = 
"Test" }; 


// Arrange - create the mock repository 
Mock<IProductRepository> mock = new Mock<IProductRe 
pository>(); 
mock.Setup(m => m.Products).Returns(new Product[] { 
new Product {ProductID = 1, Name = "P1"}, 
prod, 
new Product {ProductID = 3, Name = "P3"}, 
}.AsQueryable<Product>()); 


// Arrange - create the controller 
AdminController target = new AdminController(mock.O 
bject); 


// Act - delete the product 
target .Delete(prod.ProductID) ; 


// Assert - ensure that the repository delete metho 
d was 

// called with the correct Product 

mock.Verify(m => m.DeleteProduct(prod.ProductID) ) ; 





可 以 通过 局 动 应 用 程序 ， 导 航 


到 /Admin/Index， 然 后 单 击 商品 列表 页 面 中 的 其 中 
一 个 Delete 按 钮 来 租 看 删除 功能 ， 如 图 11-8 所 示 。 
当 从 目录 中 删除 商品 时 ， 这 里 使 用 TempData 变 量 显 
7N YE AB 





如 果 删 除 先前 已 创建 订单 的 商品 ， 则 会 肥 现 错 
误 。 当 Order 对 象 存储 在 数据 库 中 时 ， 它 将 被 转换 
为 数据 表 中 的 一 条 记录 ， 其 中 包 区 
Product 对 铺 的 引用 ， 称 为 外 键 天 系 。 这 意味 看 默认 
情况 下 ， 如 果 已 为 商品 创建 订单 ， 数 据 库 将 不 允许 
删除 Product 对 象 ， 因 为 这 样 做 会 在 数据 库 中 导致 不 
一 致 。 有 许多 方法 可 用 来 解决 此 问题 ， 包 括 在 删除 


商品 时 上 自动 删除 与 之 相关 的 订单 对 象 或 者 更 改 商 品 
和 订单 对 象 之 间 的 关系 。 详 细 信息 请 参阅 Entity 
Framework Core 文 档 。 














图 11-8 从 目录 中 删除 商品 


11.3 ”小结 


本 章 介 绍 了 管理 功能 ， 并 展示 了 如 何 实现 
CRUD 操 作 ， 从 而 允许 管理 员 在 存储 库 中 创建 、 读 





取 、 更 新 和 删除 商品 ， 并 将 订单 标记 为 已 发 贷 。 下 
一 草 将 展示 如 何 保护 管理 功能 ， 使 其 不 对 所 有 用 户 
公开 ， 并 将 SportsStore 应 用 程序 部 署 到 生产 环境 
中 。 





第 12 章 ”SportsStore 的 安全 和 部 闭 


在 上 一 章 中 ， 添 加 了 SportsStore 应 用 程序 的 管 
理 功能 ， 如 果 按 原样 部 车 应 用 程序 ， 可 能 没 人 注意 
到 任何 人 都 可 以 修改 商品 目录 。 他 们 需要 知道 的 
是 ， 任 何人 使 用 URL/Admin/Index 和 /Order/List 都 可 
以 执行 用 管理 功能 。 本 章 将 展示 如 何 通 过 密码 保护 
来 阻止 任意 用 户 使 用 管理 功能 。 一 旦 具备 了 安全 指 
施 ， 束 将 展示 如 何 准 备 和 部 普 SportsStore 应 用 程序 
到 生产 环境 中 。 








12.1 保护 管理 功能 


ASP.NET Core Identity 系 统 提 供 了 身份 验证 和 
授权 ， 该 系统 可 以 整合 到 ASP.NET Core 平 台 和 
MVC 应 用 程序 中 。 在 接 下 来 的 内 容 中 ， 将 创建 基本 


的 安全 设置 ， 人 允许 名 为 Admin 的 用 户 对 应 用 程序 中 
的 管理 功能 进行 身份 验证 和 访问 。ASP.NET Core 
Identity 提 供 了 许多 用 于 验证 用 户 映 份 和 授权 访问 应 
用 程序 特性 和 数据 的 功能 ， 可 以 在 第 28 一 30 章 中 找 
到 更 详细 的 信息 ， 其 中 将 展示 如 何 创建 和 管理 用 户 
账户 、 如 何 使 用 角色 和 策略 ， 以 及 如 何 文 持 来 自 
Microsoft、Google、Facebook 和 Twitter 等 第 三 方 的 
导 份 验证 。 但 是 ， 在 本 章 中 ， 目 标 是 获得 足够 的 功 
能 以 防止 客户 访问 SportsStore 应 用 程序 的 敏感 部 

分 ， 并 在 此 过 程 中 ， 让 你 了 解 在 MVC 应 用 中 如 何 使 
用 号 份 验 证 和 授权 。 








12.1.1 创建 身份 标识 数据 库 


ASP.NET Core Identity 系 统 具 有 无 限 的 可 配置 
性 和 可 扩展 性 ， 并 文 持 多 种 用 户 数据 存储 方式 。 这 
里 将 使 用 最 常见 的 使 用 Entity Framework Core 访 问 
的 Microsoft SQL Server 存 储 数据 。 





1. 创建 上 下 文 类 


这 里 需要 创建 一 个 数据 库 上 下 文 文件 ， 以 元 当 
数据 库 与 提供 访问 权限 的 Identity 模 型 对 象 之 间 的 桥 
深 。 在 Model 文 件 夹 中 添加 一 个 名 为 
AppIdentityDbContext.cs 的 类 文件 ， 并 用 它 定 义 代 
码 清单 12-1 所 示 的 类 。 


YO 
v A 
VE. Js. 


你 可 能 习惯 于 将 包 添 加 到 项 目 中 以 获得 安全 性 
等 其 他 功能 。 但 是 ， 随 着 ASP.NET Core 2 的 发 布 ， 
身份 标识 所 需 的 NuGet 包 已 经 包含 在 项 目 中 ， 也 束 
是 作为 项 目 模板 的 一 部 分 添加 到 SportsStore.csproj 
文件 中 的 元 数据 包 。 


代码 清单 12-1 Models 文 件 夹 下 的 AppIdentityDbContext.cs 文 件 
的 内 容 


using Microsoft .AspNetCore.Identity ; 
using Microsoft .AspNetCore.Identity.EntityFrameworkCore 


3 
using Microsoft.EntityFrameworkCore; 


namespace SportsStore.Models { 


public class AppIdentityDbContext : IdentityDbConte 
xt<IdentityUser> { 


public AppIdentityDbContext (DbContextOptions<Ap 
pIdentityDbContext> options) 
: base(options) { } 
} 





AppldentityDbContext Jk Æ H 
IdentityDbContext， 后 者 为 Entity Framework Core 提 
供 特定 于 里 份 标识 的 功能 。 对 于 type 参 数 ， 使 用 
IdentityUser 类 ， 它 是 用 于 表示 用 户 的 内 置 类 。 第 28 
章 将 演示 如 何 使 用 可 扩展 的 自 定 义 类 来 添加 应 用 程 











序 用 户 的 额外 信息 。 
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下 一 步 是 定义 数据 库 的 连接 字符 串 。 在 代码 清 
单 12-2 中 ， 可 以 看 到 对 SportsStore 项 目的 
appsettings.json 文 件 所 做 的 补充， 格式 与 在 第 8 草 中 
为 产品 数据 库 定义 的 连接 字符 串 相同 。 





代码 清单 12-2 ”在 appsettings.json 文 件 中 定义 连接 字符 串 


{ 
"Data": { 
"SportStoreProducts": { 
"ConnectionString": " Server=(localdb)\\MSSQLLoca 
1DB;Database=SportsStore;Trusted_ 
Connection=True;MultipleAct 
iveResultSets=true" 


Js 


"SportStoreIdentity": { 
"ConnectionString": " Server=(localdb)\\MSSQLLoca 
1DB;Database=Identity;Trusted_ 
Connection=True;MultipleAct 


iveResultSets=true" 
} 
} 





} 





请 记 住 ， 连 接 字 符 串 必须 在 appsettings.json 文 
件 中 的 单个 连续 行 中 定义 〈 这 里 由 于 受 版 面 宽 度 的 
限制 换行 显示 ) 。 人 代码 清单 12-2 定 义 了 一 个 名 为 
SportsStoreldentity 的 连接 字符 串 ， 其 中 指定 了 名 为 
Identity 的 LocalDB 数 据 库 。 








3. 配置 应 用 程序 


与 其 他 ASP.NET Core 功 能 一 样 ，ASP.NET 
Core Identity 在 Start 类 中 配置 。 代 码 清单 12-3 显 示 了 
使 用 上 和 面 定 义 的 上 下 文 类 和 连接 字符 串 在 
SportsStore 项 目 中 为 设置 ASP.NET Core Identity 所 做 
HAD FB o 








代码 清单 12-3 ”在 Startup.cs 文 件 中 配置 身份 标识 








using System; 

using System.Collections.Generic; 
using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 
using Microsoft.AspNetCore.Hosting; 


using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using SportsStore.Models; 

using Microsoft.Extensions.Configuration; 

using Microsoft.EntityFrameworkCore; 

using Microsoft.AspNetCore.Identity; 


namespace SportsStore { 
public class Startup { 


public Startup(IConfiguration configuration) => 
Configuration = configuration; 


public IConfiguration Configuration { get; } 


public void ConfigureServices(IServiceCollectio 
n services) { 


services .AddDbContext<ApplicationDbContext> 
(options => 
options.UseSqlServer ( 
Configuration|[ "Data:SportStoreProdu 
cts:ConnectionString"])); 


services .AddDbContext<AppIdentityDbContext> 
(options => 
options .UseSqlServer ( 
Configuration[ "Data:SportStoreIdent 
ity: ConnectionString"])); 


services.AddIdentity<IdentityUser, Identity 
Role>() 
-AddEntityFrameworkStores<AppIdentityDb 
Context>() 
.AddDefaultTokenProviders() ; 


services.AddTransient<IProductRepository, E 
FProductRepository>() ; 

services.AddScoped<Cart>(sp => SessionCart. 
GetCart(sp)); 

services .AddSingleton<IHttpContextAccessor, 
HttpContextAccessor>(); 

services.AddTransient<IOrderRepository, EFO 
rderRepository>(); 

services.AddMvc(); 

services.AddMemoryCache() ; 

services.AddSession(); 

} 
public void Configure(IApplicationBuilder app, 

IHostingEnvironment env) { 

app.UseDeveloperExceptionPage() ; 

app.UseStatusCodePages() ; 

app.UseStaticFiles(); 

app.UseSession(); 

app.UseAuthentication() ; 

app.UseMvc(routes => { 


// ... routes omitted for brevity... 


})5 
SeedData.EnsurePopulated(app) ; 





在 ConfigureServices 方 法 中 ， 扩 展 Entity 
Framework Core 配 置 以 注册 上 下 文 类 ， 并 使 用 


AddIdentity 方 法 使 用 内 置 类 来 设置 ASP.NET Core 

Identity 服 务 以 表示 用 户 和 角色。 在 Configure 方 法 

中 ， 调 用 UseAuthentication 方 法 来 设置 组 件 ， 用 于 
拦截 请 求 和 啊 应 以 实现 安全 策略 。 





4. 创建 和 应 用 数据 库 迁 移 


基本 配置 已 就 位 ， 现 在 可 以 使 用 Entity 
Framework Core 迁 移 功 能 来 定义 数据 库 架 构 并 将 其 
应 用 于 数据 库 。 打 开 新 的 命令 提示 符 或 PowerShell 
窗口 ， 并 在 SportsStore 项 目 文件 夹 中 运行 以 下 命 
令 ， 为 Identity 数 据 库 创建 新 的 迁移 : 





dotnet ef migrations add Initial --context AppIdentityD 
bContext 





与 以 前 的 数据 库 命令 的 重要 区 别 在 于 ， 使 用 - 
context 参 数 来 指定 与 要 使 用 的 数据 库 关 联 的 上 下 文 
类 的 名 称 ， 这 里 是 AppIdentityDbContext。 当 应 用 程 








序 中 有 多 个 数据 库 时 ， 确 你 使 用 正确 的 上 下 文 类 非 


— H Fntity Framework Core 生 成 了 初始 迁移 ， 
残 运行 以 下 命令 来 创建 数据 库 并 运行 迁移 命令 : 


结果 是 生成 名 为 Identity 的 LocalDB 数 据 库 ， 访 
数据 库 可 以 使 用 Visual Studio SQL Server 对 象 资源 
管理 器 进行 查看 。 





5. 定义 种 子 数据 


可 通过 在 应 用 程序 局 动 时 对 数据 库 进行 填充 来 
显 式 创 建 Admin 用 户 。 在 Models 文 件 夹 中 添加 一 个 
名 为 dentitySeedData.cs 的 类 文件 ， 并 定义 代码 清早 
12-4 所 示 的 静态 类 。 


代码 清单 12-4 Models 文 件 夹 下 的 IdentitySeedData.cs 文 件 的 内 


using Microsoft.AspNetCore. Builder; 
using Microsoft.AspNetCore.Identity; 
using Microsoft.Extensions.DependencyInjection; 


namespace SportsStore.Models { 


public static class IdentitySeedData { 
private const string adminUser = "Admin"; 
private const string adminPassword = "Secret123 
$"; 
public static async void EnsurePopulated(IAppli 
cationBuilder app) { 


UserManager<IdentityUser> userManager = app 
.ApplicationServices 
.GetRequiredService<UserManager<Identit 


yUser>>(); 


IdentityUser user = await userManager.FindB 
yIdAsync(adminUser) ; 
if (user == null) { 
user = new IdentityUser("Admin") ; 
await userManager.CreateAsync(user, adm 
inPassword) ; 





以 上 代码 使 用 了 UserManager <T> 类 ， 它 由 


ASP.NET Core Identity 作 为 服务 提供 ， 用 于 管理 用 
户 ， 如 第 28 章 所 述 。 数 据 库 用 来 查找 管理 员 账 户 ， 
管理 员 账 户 是 使 用 密码 Secret123 SEEN. AAE 
此 例 中 更 改 人 硬 编 妈 的 密码 ， 因 为 ASP.NET Core 
Identity 具 有 验证 策略 ， 会 要 求 密 码 包含 数字 和 指定 
范围 的 字符 。 有 关 如 何 更 改 验证 设置 的 详细 信息 ， 
请 参阅 第 28 章 。 











只 


a 
E 





在 开发 过 程 中 经 党 需要 对 管理 员 账 户 的 详细 信 
恩 进 行 便 编 码 ， 以 便 在 部 署 应 用 程序 后 立即 登录 并 
开始 管理 。 执 行 此 操作 时 ， 必 须 更 改 已 创建 账户 的 
密码 。 有 关 如 何 使 用 里 份 标识 更 改 密码 的 详细 信 











息 ， 请 参阅 第 28 章 。 





为 了 确保 在 应 用 程序 启动 时 填充 ldentity 数 据 
库 ， 将 代码 清单 12-5 所 示 的 语句 添加 到 Startup 类 的 
Configure 方 法 中 。 


代码 清单 12-5 在 SportsStore 文 件 夹 下 的 Startup.cs 文 件 中 填充 
Identity 数 据 库 


public void Configure(IApplicationBuilder app, IHosting 
Environment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages() ; 
app.UseStaticFiles(); 
app.UseSession(); 
app.UseAuthentication() ; 


app.UseMvc(routes => { 
// ... routes omitted for brevity... 


}); 
SeedData.EnsurePopulated(app) ; 
IdentitySeedData.EnsurePopulated(app) ; 





12.1.2 应 用 基本 授权 宽 略 


既然 已 经 配置 了 ASP.NET Core Identity, yP] 
以 将 授权 有 筑 略 应 用 于 想 要 保护 的 应 用 程序 。 可 使 用 
最 基本 的 授权 策略 ， 人 允许 任何 经 过 喘 份 验证 的 用 户 
访问 。 虽 然 这 在 实际 的 应 用 程序 中 是 一 种 有 用 的 策 
略 ， 但 还 可 以 选择 创建 更 精细 的 授权 控制 (如 第 28 
一 30 章 所 述 ) ， 但 由 于 SportsStore 应 用 程序 只 有 一 
个 用 户 ， 因 此 能 够 区 分 匿名 请 求 和 经 过 和 丑 份 验证 的 
请 求 陨 足够 了 。 

















Authorize 特 性 用 于 限制 对 操作 方法 的 访问 ， 在 
代码 清单 12-6 中 ， 可 以 看 到 已 使 用 Authorize 特 性 来 
保护 对 Order 控 制 器 中 管理 操作 的 访问 。 








代码 清单 12-6 ”限制 OrderController.cs 文 件 中 的 访问 权限 





using Microsoft.AspNetCore.Mvc; 

using SportsStore.Models; 

using System.Ling; 

using Microsoft.AspNetCore. Authorization; 


namespace SportsStore.Controllers { 


public class OrderController : Controller { 


private IOrderRepository repository; 
private Cart cart; 


public OrderController(IOrderRepository repoSer 


vice, Cart cartService) { 


d)); 


ID); 


))s 


repository = repoService; 
cart = cartService; 


[Authorize] 
public ViewResult List() => 
View(repository.Orders.Where(o => !o0.Shippe 


[HttpPost ] 
[Authorize] 
public IActionResult MarkShipped(int orderID) { 
Order order = repository.Orders 
.FirstOrDefault(o => o.OrderID == order 


if (order != null) { 
order.Shipped = true; 
repository.SaveOrder (order); 


} 


return RedirectToAction(nameof(List)); 


} 
public ViewResult Checkout() => View(new Order( 


[HttpPost | 
public IActionResult Checkout(Order order) { 
if (cart.Lines.Count() == @) { 


ModelState.AddModelError("", "Sorry, yo 
ur cart is empty!"); 


} 

if (ModelState.IsValid) { 
order.Lines = cart.Lines.ToArray(); 
repository.SaveOrder(order) ; 
return RedirectToAction(nameof (Complete 

d)); 

} else { 
return View(order) ; 

} 

} 


public ViewResult Completed() { 
cart.Clear(); 
return View(); 





由 于 不 想 阻 止 未 经 里 份 验证 的 用 户 访 问 Order 
控制 器 中 的 其 他 操作 方法 ， 因 此 仪 将 Authorize 特 性 
应 用 于 List 和 MarkShipped 操 作 方 法 。 ea 
Admin 控 制 器 定义 的 所 有 操作 方法 ， 那 么 可 以 通 
将 Authorize 特 性 应 用 于 控制 器 类 来 实现 这 一 点 ， 控 
制 颖 类 会 将 授权 策略 应 用 于 它 包 含 的 所 有 操作 方 
法 ， 如 代码 清单 12-7 所 示 。 











代码 清单 12-7 ”限制 AdminController.cs 文 件 中 的 访问 权限 





using Microsoft.AspNetCore.Mvc; 

using SportsStore.Models; 

using System.Ling; 

using Microsoft.AspNetCore.Authorization; 


namespace SportsStore.Controllers { 


[Authorize] 
public class AdminController : Controller { 
private IProductRepository repository; 


public AdminController(IProductRepository repo) 


repository = repo; 


} 


public ViewResult Index() => View(repository.Pr 
oducts); 


public ViewResult Edit(int productId) => 
View(repository.Products 
.FirstOrDefault(p => p.ProductID == pro 
ductId) ) ; 
[HttpPost ] 
public IActionResult Edit(Product product) { 
if (ModelState.IsValid) { 
repository.SaveProduct (product) ; 
TempData[ "message"] = $"{product.Name} 
has been saved"; 
return RedirectToAction("Index") ; 
} else { 
// there is something wrong with the da 


ta values 
return View(product) ; 


} 


public ViewResult Create() => View( "Edit", new 
Product()); 


[HttpPost] 
public IActionResult Delete(int productId) { 
Product deletedProduct = repository.DeleteP 
roduct(productId) ; 
if (deletedProduct != null) { 
TempData["message"] = $"{deletedProduct 
.Name} was deleted"; 


return RedirectToAction("Index") ; 





12.1.3 ENEI F2 m as F04 B] 


HRA FAREA H BIS he e to SE A es 
求 时 ， 他 们 会 被 重 定 癌 到 /AccountVLogin URL, M 
用 程序 将 提示 用 户 需 要 提供 和 凭据。 在 准备 过 程 中 ， 
可 添加 视图 模型 来 表示 用 户 的 凭据 ， 方 法 是 将 名 为 
LoginModelcs 的 类 文件 添加 到 Models/ViewModels 











文件 夹 中 ， 并 用 它 定 义 代 码 清单 12-8 所 示 的 类 。 


代码 清单 12-8 Models 人 ViewModels 文 件 夹 下 的 LoginModel.cs 
文件 的 内 容 


using System.ComponentModel .DataAnnotations; 
namespace SportsStore.Models.ViewModels { 
public class LoginModel { 


[Required] 
public string Name { get; set; } 


[Required] 
[UIHint("password")] 
public string Password { get; set; } 


public string ReturnUrl { get; set; } = "/"; 





Name 和 了 Password 属 性 已 使 用 Required 特 性 进行 
修饰 ， 访 特性 使 用 模型 验证 来 确保 必须 为 其 提供 
值 。Password 属 性 已 使 用 UIHint 特 性 进行 了 修饰 ， 
此 ， 当 在 Razor 视 图 Login 中 的 input 元 素 上 使 用 
asp-for 属 性 时 ， 标 签 助手 会 将 type 属 性 设置 为 








password; 这 样 ， 用 户 输入 的 文本 在 屏幕 上 将 是 不 
可 见 的 。 第 24 章 将 描述 UIHint 特 性 的 使 用 方法 。 


接 下 来 ， 将 一 个 名 为 AccountController.cs 的 类 
文件 添加 到 Controllers 文 件 夹 中 ， 并 用 它 定义 代码 
清单 12-9 所 示 的 控制 器 ， 以 啊 应 对 /AccountLogin 
URL 的 请 求 。 





代码 清单 12-9 ”Controllers 文 件 夹 下 的 AccountController.cs 文 件 
的 内 容 





using System.Threading.Tasks; 

using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Identity; 
using Microsoft.AspNetCore.Mvc; 

using SportsStore.Models.ViewModels; 


namespace SportsStore.Controllers { 


[Authorize] 
public class AccountController : Controller { 
private UserManager<IdentityUser> userManager; 
private SignInManager<IdentityUser> signInManag 
er; 


public AccountController(UserManager<IdentityUs 
er> userMgr, 


SignInManager<IdentityUser> signInMgr) 


userManager = userMgr; 
SignInManager = signInMgr; 


} 


[ Al lowAnonymous | 
public ViewResult Login(string returnUrl) { 
return View(new LoginModel { 
ReturnUrl = returnUrl 
})3 
} 


[HttpPost ] 
[ AllowAnonymous | 
[ValidateAntiForgeryToken | 
public async Task<IActionResult> Login(LoginMod 
el loginModel) { 
if (ModelState.IsValid) { 
IdentityUser user = 
await userManager.FindByNameAsync(1 
oginModel.Name) ; 
if (user != null) { 
await signInManager.SignOutAsync(); 
if ((await signInManager .PasswordSi 
gniInAsync(user, 
loginModel.Password, false, 
false)).Succeeded) { 
return Redirect(loginModel?.Ret 
urnUrl ?? "/Admin/Index") ; 


} 
} 
} 
ModelState.AddModelError("", "Invalid name 


or password"); 
return View(loginModel1) ; 


} 


public async Task<RedirectResult> Logout(string 
returnUrl = "/") { 
await signInManager.SignOutAsync(); 
return Redirect(returnuUr1) ; 








当 用 户 被 重 定 癌 到 /Account/Login URL 时 ， 
Login 操 作 方 法 的 GET 版 本 将 呈现 页 面 的 默认 视 
图 ， 并 提供 一 个 视图 模型 对 象 ， 该 对 象 包括 一 个 
URL。 如 果 映 份 验 证 请 求 成 功 ， 浏 览 占 将 重 定 问 到 
这 个 URL。 








身份 验证 竺 据 将 被 提交 到 Login 操 作 方 法 的 
POST 版 本 ， 访 操作 方法 使 用 了 
UserManager<IdentityUser> 和 和 





a 这 两 个 服务 是 
过 控制 锅 的 构造 函数 接收 的 ， 用 于 对 用 户 进 行 吴 
en 第 28 一 30 章 将 解释 这 些 关 是 如 


何 工 作 的 ， 但 是 现在 知道 以 下 内 容 就 足够 了 : 如 果 
身份 验证 失败 ， 那 么 将 创建 模型 验证 错误 并 呈现 默 
认 视 图 ; 但 是 如 果 身 份 验证 成 功 ， 那 么 会 在 提示 输 
入 用 户 凭据 之 前 将 用 户 重 定 癌 到 他 们 要 访问 的 
URL. 








Mes 
Of 


一 般 情 况 下 ， 使 用 客户 端 数据 验证 是 一 个 好 主 
意 。 这 可 以 减轻 服务 器 的 工作 量 ， 并 为 用 户 提示 有 
关 他 们 所 提供 数据 的 即时 反馈 。 但 是 ， 你 不 应 该 在 
客户 端 执 行 身 份 验证 ， 因 为 这 通常 涉及 将 有 效 凭 据 
发 送 到 客户 问 ， 以 便 它们 检查 用 户 输 入 的 用 户 名 和 
密码 ， 或 者 至 少 信 任 客 户 端 关于 他 们 是 否 已 成 功 通 


过 里 份 验证 的 报告 。 里 份 验 证 应 始终 在 服务 器 剖 完 
成 。 





为 了 问 Login 操 作 方 法 提供 演 染 视图 ， 创 建 
Views 人 Account 文件 夹 并 在 其 中 添加 一 个 名 为 
Login.cshtml 的 Razor 视 图 文件 ， 其 内 容 如 代码 清单 
12-10 所 示 。 


代码 清单 12-10 Views/Account 文 件 夹 下 的 Login.cshtml 文 件 的 
内 容 





@model LoginModel 
@{ 


ViewBag.Title = "Log In"; 
Layout = "_AdminLayout" ; 
} 


<div class="text-danger" asp-validation-summary="Al1">< 
/div> 


<form asp-action="Login" asp-controller="Account" metho 
d="post"> 

<input type="hidden" asp-for="ReturnUrl" /> 

<div class="form-group"> 


<label asp-for="Name"></label> 
<div><span asp-validation-for="Name" class="tex 
t-danger"></span></div> 
<input asp-for="Name" class="form-control" /> 
</div> 
<div class="form-group"> 
<label asp-for="Password"></label> 
<div><span asp-validation-for="Password" class= 
“text-danger"></span></div> 
<input asp-for="Password" class="form-control" 


/> 


</div> 


<button class="btn btn-primary" type="submit">Log I 
n</button> 


</form> 














最 后 一 步 是 更 改 共享 的 管理 布局 ， 可 通过 添加 
一 个 按钮 ， 向 Logout 操 作 发 送 请 求 使 当前 用 户 注销 
登录 ， 如 代码 清单 12-11 所 示 。 这 是 一 个 非常 有 用 
的 功能 ， 可 以 让 你 更 轻松 地 测试 应 用 程序 。 如 果 没 
有 这 个 功能 ， 那 么 需要 清除 浏览 器 的 cookie 才 能 返 
回 未 经 身份 验证 的 状态 。 





代码 清单 12-11 ”在 _AdminLayout.cshtml 文 件 中 添加 Log Out 按 
钮 


<!DOCTYPE html> 


<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
<title>@ViewBag.Title</title> 
<style> 
.input-validation-error { 
border-color: red; 
background-color: #fee; 
} 
</style> 
<script src="/lib/jquery/dist/jquery.min.js"></scri 
pt> 
<script src="/lib/jquery-validation/dist/jquery.val 
idate.min.js"></script> 
<script 
src="/1lib/jquery-validation-unobtrusive/jquery.va 
lidate.unobtrusive.min.js"> 
</script> 
</head> 
<body class="m-1 p-1"> 
<div class="bg-info p-2 row"> 
<div class="col"> 
<h4>@ViewBag. Title</h4> 
</div> 
<div class="col-2"> 
<a class="btn btn-sm btn-primary" 
asp-action="Logout" asp-controller="Acco 
unt">Log Out</a> 
</div> 
</div> 
@if (TempData["message"] != null) { 
<div class="alert alert-success mt-1">@TempData 
[ "message" |</div> 


} 
@RenderBody() 
</body> 
</html> 


12.1.4 测试 安全 策略 


一 切 瓯 络 后 ， 你 吏 可 以 通过 局 动 应 用 程序 并 请 
求 /Admin/Index 来 测试 安全 策略 了 。 由 于 你 目前 尚 
未 经 过 里 份 验 证 ， 并 且 和 演 试 访问 需要 授权 的 操作 ， 
此 你 的 浏览 器 将 被 重 定 同 到 /Account/Login 
URL。 输 入 Admin 和 Secret123$〔 作 为 用 户 名 和 密 
1) 并 提交 表单 。Account 控 制 器 将 检查 提供 的 凭 
据 以 及 添加 a 到 Identity 数 据 库 中 的 种 子 数据 ， 如 有 果 输 
入 了 正确 的 信息 ， 就 会 对 你 进行 号 份 验证 并 将 浏览 
髓 重 定 回回 /AccounVLogin URL， 现 在 束 可 以 进行 
访问 了 。 图 12-1 说 明了 上 述 过 程 。 











图 12-1 管理 验证 /授权 过 程 


12.2 HBA RE 


SportsStore 应 用 程序 的 所 有 特性 和 功能 都 已 到 
位 ， 因 此 是 时 候 准 备 将 应 用 程序 部 署 到 生产 环境 中 
了 。ASP.NET Core MVC 应 用 程序 有 很 多 托管 选 
项 ， 本 章 使 用 的 是 Microsoft Azure 平 台 ， 选 择 它 是 
因为 它 来 自 微 软 ， 而 且 提 供 免 费 账户 ， 这 意味 着 即 
使 不 想 将 Microsoft Azure 用 于 目 己 的 项 目 ， 也 可 以 
一 直 使 用 SportsStore 示 例 。 


YO 
vy ae. 
ve de 


你 需要 一 个 Microsoft Azurelk A. go Rik 
有 ， 可 以 在 Microsoft 官 网 上 申请 免费 账户 。 


12.2.1 创建 数据 库 


我 们 从 创建 SportsStore 应 用 程序 将 在 生产 环境 
中 使 用 的 数据 库 开 始 。 这 个 操作 可 以 在 Visual 
Studio 部 署 过 程 中 执行 ， 但 这 有 点 像 鸡 与 捍 的 关 


系 ， 由 于 需要 在 部 署 之 前 知道 数据 库 的 连接 字符 
串 ， 因 此 需要 先 完成 创建 数据 库 的 过 程 。 








1k 


(EK = [A] Microsoft Azure J D Re HAA OH 
有 功能 ， 因 此 Microsoft Azure 门 户 网 站 经 常 更 新 。 

在 撰写 这 些 内 容 时 ， 本 市 中 的 说 明 是 准确 的 ， 但 是 
在 你 阅读 本 书 时 ， 上 兵 需 的 步骤 可 能 会 略 有 改变 。 基 


本 方法 应 该 仍然 相同 ， 但 数据 字段 的 名 称 和 步骤 的 


确切 顺序 可 能 需要 通过 一 些 实验 才能 获得 正确 的 结 
2 


最 简单 的 方法 是 使 用 Microsoft Azure 账 户 登 录 


Azure 门 户 网 站 并 手动 创建 数据 库 。 登 录 后 ， 选 择 


SQL Databases resource 类 别 ， 然 后 单 击 Add 按 钮 以 
创建 新 的 数据 库 。 


对 于 第 一 个 数据 库 ， 和 输入 名 称 products。 单 击 
Configure Required Settings 链 接 ， 然 后 单 击 Create a 
New Server 链 接 。 输 入 新 的 服务 器 名 称 在 
Microsoft Azure 中 必须 是 唯一 的 ) ， 并 选择 数据 库 
管理 员 的 用 户 名 和 密码 。 此 处 输入 服务 器 名 称 
Sportsstorecore2db， 数 据 库 管理 员 的 用 户 名 为 
sportsstoreadmin， 密 人 码 为 Secret123$。 你 需要 使 用 
不 同 的 服务 器 名 称 ， 建 议 使 用 更 复 淋 的 密码 。 选 择 
数据 库 的 位 置 ， 单 击 Select 按 钮 以 关闭 选项 ， 然 后 
单 击 Create 按 钮 以 创建 数据 库 。Microsoft Azure 将 花 
费 几 分 钟 时 间 来 执行 创建 过 程 ， 之 后 它 将 出 现在 


SQL Databases resource 类 别 中 。 

















创建 另 一 个 SQL 服务 器 ， 这 次 输入 名 称 
identity。 可 以 使 用 刚刚 创建 的 数据 库 服 务 器 ， 而 不 
需要 创建 新 的 数据 库 服 务 右 。 络 末 是 Microsoft 
Azure 托 管 的 两 个 SQL Server 数 据 库 ， 其 详细 信息 如 





表 12-1 所 示 。 你 将 拥有 不 同 的 数据 库 服 务 吉 名称 ， 
理想 情况 下 ， 你 应 该 使 用 更 健壮 的 密码 。 


表 12-1 ”SportsStore 应 用 程序 的 Microsoft Azure 数 据 库 


























identity sportsstorecore2db Secret123$ 


1. 配 兽 防火 墙 访问 权限 





需要 按照 数据 库 架 构 填 充 数据 ， 最 简单 的 方法 
是 打开 Microsoft Azure 防 火场 ， 以 便 从 开 肥 机 器 运 


行 Entity Framework Core 命 令 。 





选择 SQL Databases resource 类 别 中 的 任意 数据 
库 ， 单 击 Tools 按 钮 ， 然 后 单 击 Open in Visual Studio 
链接 。 现 在 单 击 Configure Your Firewall 链 接 ， 单 击 


Add Client 了 按钮 ， 然 后 单 击 Save 按 钮 ， 这 将 允许 
你 从 当前 IP 地 址 访问 数据 库 服务 器 并 执行 配置 命令 

(可 以 通过 单 击 Open In Visual Studio 按 钮 来 检查 数 
据 库 架构 ， 这 将 打开 Visual Studio 并 使 用 SQL Server 
XY Ze GE Wi E EH AS OR ha FH JE) 。 








2. 获取 连接 字符 串 








接 下 来 需要 新 的 数据 库 连 接 字 符 串 。 当 通过 
Show Database Connection Strings 链 接 单 击 SQL 
Databases resource 类 别 中 的 数据 库 时 ，Microsotft 
Azure 会 为 不 同 的 开发 平台 提供 连接 字符 串 ， 这 
是 .NET 应 用 程序 所 需 的 ADO.NET 字 符 串 。 以 下 是 
Microsoft Azure 门 户 为 products 数 据 库 提供 的 连接 字 
ITR: 











Server=tcp:sportsstorecore2db.database.windows.net, 1433 
;Initial Catalog=products;Persist 
Security Info=False;User ID={your_username};Password={y 
our_password};MultipleActiveResult 
Sets=True; Encrypt=True; TrustServerCertificate=False;Con 


nection Timeout=30; 


你 将 看 到 不 同 的 配置 选项 ， 具 体 取 决 于 
Microsoft Azure 如 何 配 置 数 据 库 。 请 注意 ， 用 户 名 
和 密码 有 占 位 符 ， 这 里 已 经 用 粗 体 标记 了 ， 当 使 用 
连接 字符 串 配置 应 用 程序 时 必须 更 改 这些 值 。 





12.2.2 ”准备 应 用 程序 


在 部 署 应 用 程序 之 前 ， 还 有 一 些 基本 的 准备 工 
作 要 做 ， 以 便 为 生产 环境 做 好 准备 。 在 接 下 来 的 内 
容 中 ， 将 更 改 错误 的 显示 方式 并 设置 数据 库 的 生产 
环境 连接 字符 串 。 














1. 创建 Error 控 制 器 和 视图 








目前 ， 应 用 程序 已 配置 为 使 用 开 及 人 员 友 好 的 
错误 页 面 ， 这 些 页 面 在 出 现 问 题 时 可 以 提供 有 用 的 
信息 。 这 不 是 最 终 用 户 应 该 看 到 的 信息 ， 因 此 将 一 





个 名 为 ErrorController.cs 的 类 文件 添加 到 Controllers 
文件 夹 中 ， 并 用 它 定 义 代码 清单 12-12 所 示 的 简单 
FEMIAS o 





代码 清单 12-12 ”Controllers 文 件 夹 下 的 ErrorController.cs 文 件 的 
内 容 


using Microsoft.AspNetCore.Mvc; 


namespace SportsStore.Controllers { 


public class ErrorController : Controller { 


public ViewResult Error() => View(); 





Error 控 制 器 定义 了 呈现 默认 视图 的 Error 操 作 方 
法 。 为 了 给 Error 控 制 右 提供 视图 ， 创 建 Views/Error 
文件 来， 添加 一 个 名 为 Error.cshtml 的 Razor 视 图 文 
件 ， 在 其 中 编写 代码 清单 12-13 所 示 的 代码 。 


代码 清单 12-13 ”Views/Error 文 件 夹 下 的 Error.cshtml 文 件 的 内 


mL 


4 


@{ 
Layout = null; 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 
<link rel="stylesheet" href="~/lib/bootstrap/dist/c 
ss/bootstrap.min.css" /> 
<title>Error</title> 
</head> 
<body> 
<h2 class="text-danger">Error.</h2> 
<h3 class="text-danger">An error occurred while pro 
cessing your request.</h3> 
</body> 
</html> 











这 种 错误 页 面 是 万 不 得 已 的 选择 ， 最 好 尽 可 能 
简单 ， 而 不 要 依赖 共 孕 视图、 视图 组 件 或 其 他 功 
能 。 在 本 例 中 ， 禁 用 共 至 布局 并 定义 一 个 简单 的 
HTML 文档 ， 该 HIML 文 档 说 明 出 现 了 错误 ， 但 并 
未 提供 错误 的 任何 信息 。 





2. 定义 生产 数据 库 设置 


下 一 步 是 创建 一 个 文件 ， 访 文件 将 为 应 用 程序 
提供 生产 环境 中 的 数据 库 连 接 字 符 串 。 回 
SportsStore 项 目 添 加 一 个 名 为 
appsettings.production.json 的 ASP.NET 配 置 文件 ， 并 
添加 代码 清单 12-14 所 示 的 内 容 。 


or 


fe 示 





GTR TT SE AV E EAS KREEF 
表 中 的 appsettings.json 中 ， 如 果 稍 后 想 再 次 编辑 该 
文件 ， 就 必须 先 展开 。 





代码 清单 12-14 appsettings.production.json 文 件 的 内 容 


{ 
"Data": { 
"SportStoreProducts": { 

"ConnectionString": "Server=tcp:sportsstorecore2d 
b.database.windows.net,1433;Initial 

Catalog=products;Persist Security Info=False;User 
ID={your_username} ; Password={your _ 

password} ;MultipleActiveResultSets=True;Encrypt=T 
rue; TrustServerCertificate=False; 

Connection Timeout=30;" 


Jo 
"SportStoreIdentity": { 
"ConnectionString": "Server=tcp:sportsstorecore2d 
b.database.windows.net,1433;Initial 
Catalog=identity;Persist Security Info=False;User 
ID={your_username} ; Password={your _ 
password} ;MultipleActiveResultSets=True;Encrypt=T 
rue; TrustServerCertificate=False; 
Connection Timeout=30; " 








IOP SCPE ARE Del BE, AE BEE RF BN ES E 
行 。 这 个 文件 复制 了 appsettings.json 文 件 的 连接 字 
从 串 部 分 ， 但 使 用 Y Microsoft Azure 连 FFP 
Calls J BHR PP 4 AS AP) 。 这 里 还 将 
MultipleActiveResultSetsi S. /yTrue, iX an 多 个 并 














及 得 询 ， 并 避免 在 执行 复杂 LINQ 碍 询 时 的 利 见 错 


误 情况 。 


W 


> a 
E O R. 





在 将 用 户 名 和 密码 插入 连接 字符 串 时 需要 删除 
括号 字符 ， 最 终结 果 应 该 是 Password=MyPassword 
而 不 是 Password={MyPassword}。 


3. 配置 应 用 程序 


现在 可 以 更 改 Startup 类 ， 这 样 应 用 程序 在 生产 
环境 中 残 会 执行 不 同 的 操作 。 代 码 清单 12-15 显 示 


了 所 做 的 更 改 。 


代码 清单 12-15 在 Startup.cs 文 件 中 配置 应 用 程序 








using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using SportsStore.Models; 

using Microsoft.Extensions.Configuration; 
using Microsoft.EntityFrameworkCore; 
using Microsoft.AspNetCore.Identity; 


namespace SportsStore { 
public class Startup { 


public Startup(IConfiguration configuration) => 
Configuration = configuration; 


public IConfiguration Configuration { get; } 


public void ConfigureServices(IServiceCollectio 
n services) { 
services .AddDbContext<ApplicationDbContext> 
(options => 
options.UseSqlServer ( 
Configuration[ "Data:SportStoreProdu 
cts:ConnectionString"])); 


services.AddDbContext<AppIdentityDbContext> 
(options => 
options.UseSqlServer ( 
Configuration[ "Data:SportStoreIdent 
ity:ConnectionString"])); 


services.AddIdentity<IdentityUser, Identity 
Role>() 
.AddEntityFrameworkStores<AppIdentityDb 
Context>() 
.AddDefaultTokenProviders(); 


services.AddTransient<IProductRepository, E 
FProductRepository>() ; 
services.AddScoped<Cart>(sp => SessionCart. 
GetCart(sp)); 
services .AddSingleton<IHttpContextAccessor, 
HttpContextAccessor>(); 
services.AddTransient<IOrderRepository, EFO 
rderRepository>(); 
services.AddMvc(); 
services .AddMemoryCache() ; 
services.AddSession() ; 
} 
public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 


if (env.IsDevelopment()) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages() ; 

} else { 
app.UseExceptionHandler("/Error"); 


} 


app.UseStaticFiles(); 


app.UseSession() ; 
app.UseAuthentication( ) ; 
app.UseMvc(routes => { 
routes .MapRoute(name: "Error", template 


"Error", 
defaults: new { controller = "Error 
", action = "Error" }); 
routes .MapRoute(name: null, 
template: "{category}/Page{productP 
age:int}", 
defaults: new { controller = "Produ 
ct", action = "List" } 


); 
routes .MapRoute(name: null,template: "P 
age{productPage:int}", 
defaults: new { controller = "Produ 
ct", 
action = "List", productPage = 1 } 
) ; 
routes .MapRoute(name: null, template: 


{category}", 


defaults: new { controller = "Produ 
ct", 
action = “List", productPage = 
1} 
); 
routes .MapRoute(name: null,template: "" 
3 
defaults: new { controller = "Produ 
Cr"; 
action = "List", productPage = 
1 }); 


routes .MapRoute(name: null, template: 
{controller}/{action}/{id?}"); 


}); 
//SeedData.EnsurePopulated (app) ; 


//IdentitySeedData. EnsurePopulated(app) ; 





IHostingEnvironment 接 口 用 于 提供 有 关 运 行 应 
用 程序 的 环境 信息 ， 例 如 ， 当 前 运行 环境 为 开发 环 
境 还 是 生产 环境 。 当 托管 环境 设置 为 Production 
时 ，ASP.NET Core 将 加 载 appsettings.production.json 
J ae 用 来 覆盖 appsettings.json 文 件 中 的 
设置 ， 这 意味 着 Entity Framework Core 将 连接 到 
Microsoft Azure 数 据 库 而 不 是 LocalDB。 可 以 使 用 
很 多 选项 在 不 同 环境 中 定制 应 用 程序 的 配置 ， 这 将 
在 第 14 章 中 解释 。 











这 里 还 注释 了 数据 库 的 填充 语句 ，12.2.4 节 将 


解释 这 些 语句 。 


12.2.3 ”应 用 数据 库 迁 移 











要 使 用 应 用 程序 所 需 的 染 构 设置 数据 库 ， 请 打 
开 新 的 命令 提示 符 或 PowerShell 窗 口 ， 然 后 导航 到 
SportsStore 项 目 文件 来 。 首 先 需 要 设置 环境 变量 ， 
以 便 dotnet 命 令 行 工具 使 用 Microsoft Azure 连 接 字 符 
串 。 如 果 使 用 的 是 PowerShell， 请 使 用 以 下 命令 设 
置 环 境 变 量 : 


如 果 使 用 的 是 命令 提示 符 ， 请 使 用 以 下 命令 设 
置 环境 变 量 : 


在 SportsStore 项 目 文件 夹 中 运行 以 下 命令 ， 以 
将 项 目 中 的 迁移 应 用 于 Microsoft Azure 数 据 库 : 





dotnet ef database update --context ApplicationDbContex 
t 


dotnet ef database update --context AppIdentityDbContext 


环境 变量 指定 了 用 于 获取 连接 字符 串 以 访问 数 
据 库 的 宿主 环境 。 如 果 这 些 命令 不 起 作用 ， 请 确保 
己 将 Microsoft Azure 防 火 墙 配置 为 允许 开发 计算 机 
访问 (如 本 章 前 面 所 述 ) ， 并 且 已 正确 复制 和 修改 
了 连接 字符 串 。 





12.2.4 管理 数据 库 填充 


代码 清单 12-15 注 释 挥 了 Startup 类 中 用 于 填充 数 
据 库 的 语句 。 这 样 做 是 因为 用 于 将 迁移 应 用 于 数据 
库 的 Entity Framework Core 命 令 依赖 于 Startup 类 设 
置 的 服务 ， 这 意味 着 在 局 用 这 些 语 句 的 情况 下 ， 将 
在 应 用 迁移 之 前 调用 为 数据 库 设 定 填 充 数据 的 代 
码 ， 这 会 导致 错误 并 阻止 迁移 工作 。 设 置 数 据 库 
时 ， 这 不 会 导致 问题 。 但 对 于 生产 数据 库 ， 因 为 
SeedData. evan 方法 在 填 a 用 
迁移 ， 还 因为 在 迁移 应 用 到 数据 库 之 前 ， 还 没 
mre 到 应 用 程序 中 ， 所 以 会 出 
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方法 。 对 于 用 户 账户 ， 建 议 在 登录 时 使 用 管理 员 账 
户 填 充 数据 库 。 这 里 将 为 管理 工具 添加 一 个 功能 ， 
用 于 填充 products 数 据 库 ， 以 便 生产 系统 可 以 填充 
测试 数据 ， 或 者 根据 需要 留 空 以 获取 实际 数据 。 
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在 生产 系统 中 填充 验证 数据 时 应 齐 层 处理， 并 
且 应 用 程序 应 使 用 第 28~30 章 中 描述 的 功能 ， 在 部 
普 后 立即 更 改 密码 。 








1. 填充 里 份 数据 


更 改 用 户 数 据 填 充 方式 的 第 一 步 是 简化 
IdentitySeedData 类 中 的 代码 ， 如 代码 清单 12-16 所 
7S 0 


代码 清单 12-16 ”简化 Models 文 件 夹 下 的 IdentitySeedData.cs 文 
件 中 的 代码 





using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore.Identity; 

using Microsoft.Extensions.DependencyInjection; 
using System. Threading. Tasks; 


namespace SportsStore.Models { 


public static class IdentitySeedData { 
private const string adminUser = "Admin"; 
private const string adminPassword = "Secret123 


$"; 


public static async Task EnsurePopulated(UserMa 
nager<IdentityUser> 
userManager) { 


IdentityUser user = await userManager.FindB 
yIdAsync(adminUser) ; 
if (user == null) { 
user = new IdentityUser("Admin" ) ; 


await userManager.CreateAsync(user, adm 


inPassword); 





EnsurePopulated 方 法 接收 一 个 对 象 作 为 参数 ， 
而 不 是 在 内 部 获取 UserManager <IdentityUser> 服 
务 。 这 样 就 可 以 将 数据 库 填充 集成 到 
AccountController 类 中 ， 如 代码 清单 12-17 所 示 。 





代码 清单 12-17 在 Controllers 文 件 夹 下 的 AccountController.cs 
文件 中 填充 数据 





using System.Threading.Tasks; 

using Microsoft.AspNetCore.Authorization; 
using Microsoft .AspNetCore.Identity ; 
using Microsoft.AspNetCore.Mvc; 

using SportsStore.Models.ViewModels ; 
using SportsStore.Models; 


namespace SportsStore.Controllers { 


[Authorize] 
public class AccountController : Controller { 
private UserManager<IdentityUser> userManager; 
private SignInManager<IdentityUser> signInManag 
er; 


public AccountController(UserManager<IdentityUs 
er> userMgr, 
SignInManager<IdentityUser> signInMgr) 


{ 
userManager = userMgr; 
SignInManager = signInMgr; 
IdentitySeedData.EnsurePopulated(userMgr) .W 
ait(); 


// ...other methods omitted for brevity... 





这 些 更 改 将 确保 每 次 创建 AccountController 对 
象 以 处 理 HTTP 请 求 时 ， 都 会 为 Identity 数 据 库 填充 
数据 。 当 然 ， 这 并 不 是 很 理想 ， 但 是 并 没有 很 好 的 
方法 来 为 数据 库 填 元 数据 ， 这 种 方法 将 确保 应 用 程 
序 可 以 在 生产 环境 和 开发 环境 中 进行 管理 ， 尽 管 代 
价 是 产生 一 些 额 外 的 数据 库 租 询 。 





2. 填充 产品 数据 


对 于 产品 数据 ， 这 里 将 疝 定 理 员 提 供 一 个 按 


ee 
是 更 改 数据 填充 代码 ， 以 便 使 用 一 个 接口 ， 
-o 二 控制 器 而 不 是 Startup 类 提供 的 服务 ， 
如 代码 清单 12- 这 里 还 注释 了 目 动 应 用 挂 
起 迁移 的 任何 语句 ， 这 可 能 导致 数据 丢失 ， 因 此 在 
生产 环境 中 只 a : 


代码 清单 12-18 ”准备 在 Models 文 件 夹 下 的 SeedData.cs 文 件 中 
手动 填充 数据 





using System.Ling; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.EntityFrameworkCore; 

using System; 


namespace SportsStore.Models { 
public static class SeedData { 


public static void EnsurePopulated(IServiceProv 
ider services) { 
ApplicationDbContext context = 
services .GetRequiredService<Application 
DbContext>(); 
//context.Database.Migrate() ; 
if (!context.Products.Any()) { 


context .Products .AddRange( 


// ...statements omiited for brevit 


J3 


context.SaveChanges(); 
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填充 操作 的 操作 方法 ， 如 代码 清单 12-19 所 示 。 





代码 清单 12-19 ”在 Controllers 文 件 夹 下 的 AdminController.cs 文 
件 中 填充 数据 库 





using Microsoft.AspNetCore.Mvc; 

using SportsStore.Models; 

using System.Ling; 

using Microsoft.AspNetCore. Authorization; 


namespace SportsStore.Controllers { 
[Authorize] 
public class AdminController : Controller { 


private IProductRepository repository; 


public AdminController(IProductRepository repo) 


repository = repo; 


} 


public ViewResult Index() => View(repository.Pr 
oducts); 


// ...other methods omitted for brevity... 


[HttpPost ] 
public IActionResult SeedDatabase() { 
SeedData.EnsurePopulated(HttpContext.Reques 
tServices) ; 
return RedirectToAction(nameof (Index) ) ; 








对 新 的 操作 方法 使 用 HttpPost 特 性 进行 修饰 ， 
以 便 可 以 使 用 POST 请 求 进行 定位 ， 并 且 一 旦 数据 
ERAT., WKN A aS EE m Index ET. Hl 
下 的 束 是 创建 一 个 按钮 来 填充 数据 库 ， 如 代码 清单 
12-20 所 示 。 








代码 清单 12-20 ”在 Views/Admin 文 件 夹 下 的 Index.cshtml 文 件 中 
添加 一 个 按钮 


@model IEnumerable<Product> 


@{ 
ViewBag.Title = “All Products"; 


Layout = "_AdminLayout"; 
} 


@if (Model.Count() == @) { 
<div class="text-center m-2"> 
<form asp-action="SeedDatabase" method="post" > 
<button type="submit" class="btn btn-danger 
">Seed Database</button> 
</form> 
</div> 
} else { 
<table class="table table-striped table-bordered ta 
ble-sm"> 
<tr> 
<th class="text-right">ID</th> 
<th>Name</th> 
<th class="text-right">Price</th> 
<th class="text-center">Actions</th> 
</tr> 
@foreach (var item in Model) { 
<tr> 
<td class="text-right">@item.ProductID< 
/td> 
<td>@item.Name</td> 
<td class="text-right">@item.Price.ToSt 
ring("c")</td> 
<td class="text-center"> 
<form asp-action="Delete" method="p 
ost"> 
<a asp-action="Edit" class="btn 
btn-sm btn-warning" 
asp-route-productId="@item.P 
roductID"> 
Edit 


</a> 
<input type="hidden" name="Prod 
uctID" 
value="@item.ProductID" /> 
<button type="submit" class="bt 
n btn-danger btn-sm"> 
Delete 
</button> 
</form> 
</td> 
</tr> 
} 
</table> 


} 
<div class="text-center"> 
<a asp-action="Create" class="btn btn-primary">Add 
Product</a> 
</div> 





12.2.5 XAM HIE 





要 部 署 应 用 程序 ， 请 在 Solution Explorer fa t P 
右 击 SportsStore 项 目 ， 然 后 从 弹出 的 来 单 中 选择 
Publish. Visual Studio 将 为 你 提供 一 系列 发 布 方 
法 ， 如 图 12-2 所 示 。 








图 12-2 发布 方 法 


如 果 部 普 失 败 ， 如 何 处 理 





部 署 失败 的 最 可 能 原因 是 连接 字符 串 错 误 ， 要 
么 因为 没有 从 Microsoft Azure 中 正确 复制 ， 要 人 么 
为 编辑 错误 ， 没 有 正确 插入 用 户 名 和 密码 。 如 采 部 
团 失败， 首先 应 该 检查 连接 字符 串 。 如 有 果 在 “应 用 
数据 库 迁 移 ” 部 分 没有 从 dotnet ef database update 命 
令 获 得 预期 结果 ， 部 署 将 失败 。 如 末 命 令 人 确实 有 效 
但 部 蜀 失 败 ， 那 么 请 确保 已 设置 环境 变量 ， 因 为 你 
可 能 正在 使 用 本 地 数据 库 而 不 是 云 中 的 数据 库 。 

















选择 Microsoft Azure App Service 选 项 ， 并 确保 
选中 Create New (Select Existing 用 于 更 新 现 有 的 已 
部 普 的 应 用 程序 ) 。 系 统 将 提示 你 提供 部 普 的 详细 
言 轧 。 首 先 单 击 Add an Account， 然 后 输入 


Microsoft Azure E . 








输入 凭据 后 ， 可 以 选择 已 部 署 应 用 程序 的 名 称 
并 输入 服务 的 详细 信息 ， 具 体 取 决 于 拥有 的 
Microsoft Azure 账 户 类 型 、 要 部 署 的 区 域 以 及 所 需 
的 部 普 服 务 ， 如 图 12-3 所 示 。 





Create App Service HBB Microsoft account R 
Host your web and mobile applications, REST APIs, and more in Azure a 
Services SportsStoreCore-2 


Subscription 


Visual Studio Enterprise ~ 


Resource Group 


App Service Plan 


SportsStoreCore2Plan* ~ 


Clicking the Create button will create the following Azure resources 
Explore additional Azure services 


App Service - SportsStoreCore-2 


App Service Plan - SportsStoreCore2Plan 


If you have removed your spending limit or you are using Pay as You Go, there may be monetary impact if you provision additional resources. 
Learn More 





图 12-3 ”创建 新 的 Microsoft Azure App 服 务 


配置 完 服务 后 ， 单 击 Create 按 钮 。 设 置 服务 
后 ， 系 统 将 显示 发 布 摘要 ， 将 应 用 程序 发 布 到 托管 
服务 ， 如 图 12-4 所 示 。 


eames Publish 


Connected Services Publish your app to Azure or another host. Learn mor 


T SportsStoreCore-2- Web Deploy 


Create new profile 


Summary 


Site URL http://sportsstorecore-2.arurewebsites.net [P Settings. 
Resource Group core? Preview 
Configuration Release Rename profile 
Username SSportsStoreCore-2 Delete profile 


Password 





图 12-4 ”服务 的 友 布 摘要 


单 击 Publish 控 钮 开始 部 普 过 程 。 通 过 从 Visual 
Studio HJ 32 =F Ae FE View > Other Windows > Web 
Publish Activity， 可 以 伍 看 发 布 进度 。 在 此 过 程 中 
请 耐心 等 待 ， 因 为 将 项 目 中 的 所 有 文件 用 送 到 
Azure 服 务 可 能 需要 一 段 时 间 。 后 续 更 新 将 会 更 
快 ， 因 为 只 会 传输 修改 的 文件 。 


Ube sea», Visual Studio 将 为 部 普 好 的 应 用 
程序 打开 一 个 新 的 浏览 器 窗口 。 由 于 products 数 据 
库 为 空 ， 你 将 看 到 图 12-5 所 示 的 布局 。 





D to x 
© sportsstorecore-2.azurewebsites.net tr| : 
SPORTS STORE 回 
Home 








图 12-5 已 部 车 应 用 程序 的 初始 状态 


导航 到 /Admin/Index URL 并 使 用 用 户 名 Admin 


和 密码 Secret123$ 进 行 续 份 验证 。Identity 数 据 库 将 
按 需 填充 数据 ， 人 允许 你 登录 应 用 程序 的 管理 后 台 ， 
如 图 12-6 所 示 。 

















图 12-6 ”管理 页 面 


单 击 Seed Database 按 钮 以 填充 products 数 据 
库 ， 这 将 产生 图 12-7 所 示 的 结果 。 然 后 ， 可 以 导航 
回应 用 程序 的 根 URL 并 正 第 使 用 。 

















图 12-7 ”填充 数据 后 的 数据 库 
12.3 ”小结 


本 草 和 前 几 音 演示 了 如 何 通 过 ASP.NET Core 
MVC 创 建 一 个 现实 的 电子 商务 应 用 程序 。 这 个 扩展 
的 示例 引入 了 许多 关键 的 MVC 特 性 一 一 控制 器 、 操 
作 方 法 、 路 由 、 视 图 、 元 数据 、 验 证 、 布 局 、 壬 份 
验证 等 。 本 半 还 讲述 了 如 何 使 用 与 MVC 相 关 的 一 些 
KREN, Entity Framework Core、 依 赖 注入 
和 单元 测试 。 这 个 最 终 的 SportsStore 应 用 程序 拥有 


干 立 的 、 面 回 组 件 的 体系 结构 ， 从 而 将 各 种 关注 点 
和 易于 扩展 及 维护 的 代码 库 分 离开 来 。 下 一 章 将 展 
示 如 何 使 用 Visual Studio 代 码 来 创建 ASP.NET Core 
MVC 应 用 程序 。 


第 13 音 ”使 用 Visual Studio Code 


本 章 将 展示 如 何 使 用 Visual Studio Code 创 建 
ASP.NET Core MVC 应 用 程序 ，Visual Studio Code 
是 一 个 由 微软 开发 的 开源 路 平 台 编 辑 器 。 虽 然 名 称 
如 此 ， 但 Visual Studio Code 与 Visual Studio 无 关 ， 
Visual Studio Code 基 于 Electron 框 架 ， 很 多 其 他 Web 
应 用 程序 框架 〈 如 Angular) 的 开发 人 员 使 用 的 
Atom 编 辑 占 也 基于 这 个 框架 。 





Visual Studio Code 文 持 Windows、macOS 和 最 
流行 的 Linux 发 行 版 。Visual Studio Code 现 已 发 展 为 
强大 且 功 能 齐全 的 开发 环境 ， 尺 管 尚 未 提供 Visual 
Studio 的 所 有 功能 。 作 者 目 己 也 越 来 越 多 地 使 用 
Visual Studio Code， 因 为 它 易 于 使 用 、 速 度 很 快 ， 
而 且 对 其 他 语言 〈《 如 JavaScript 和 TypeScript) 的 文 


持 也 很 好 。 
13.1 设置 开发 环境 


设置 Visual Studio Code 需 要 执行 一 些 额 外 步 

， 因 为 有 些 功 能 在 Visual Studio 中 是 默认 提供 
a 但 对 于 Visual Studio Code 来 说 ， 需 要 由 外 部 工 

有 具 处 理 。 其 中 一 些 工 具 与 Visual Studio 使 用 的 工具 

相同 ， a 些 工 具 对 .NET 开 发 世界 来 说 是 全 新 
的 ， 你 可 能 还 不 熟悉 。 但 好 消息 是 ， 这 些 工 具 在 其 
人 的 开 有 人员 中 已 经 得 到 广泛 使 
用 ， 质 量 和 功能 都 很 优秀 。 接 下 来 将 引导 你 安装 
Visual Studio Code 以 及 MVC 开 发 所 需 的 基本 工具 和 
附件 。 














13.1.1 安装 Node.js 


在 客户 端 开发 中 ，Node.js (也 称 为 Node) 已 经 


成 为 许多 流行 的 开发 工具 所 依赖 的 运行 时 。Node.js 
是 在 2009 年 创建 的 ， 是 用 JavaScript 为 服务 器 端 应 用 
程序 编写 的 简单 高 效 的 运行 时 。Node.js$ 基 于 
Chrome 浏 览 器 中 使 用 的 JavaScript 引 擎 ， 并 提供 了 
FED a A Ba ZT JavaScript {ti API. 





Node.js 作 为 应 用 程序 服务 器 已 经 取得 了 一 些 成 
功 ， 对 于 本 章 来 说 ，Node.js$ 为 新 一 代 跨 平台 的 构建 
工具 和 包 管 理 器 提供 了 基础 。Node.js 团 队 的 一 些 明 
智 的 设计 决策 和 Chrome JavaScript 运 行 时 提供 的 器 
平台 文 持 为 那些 热情 的 工具 开发 者 ， 特 别 古 那些 想 
要 文 持 Web 应 用 程序 开发 的 人 提供 了 机 会 。 





S 
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有 两 个 可 以 使 用 的 Node.js 版 本 : 长 期 支持 
(LTS) 版 本 为 生产 环境 中 的 部 著 提 供 了 稳定 的 基 
础 ， 在 生产 环境 中 要 尺 量 减少 变更 ，LTS 版 本 更 新 
每 6 个 月 发 布 一 次 ， 并 会 维护 18 个 月 ; 当前 版 本 是 
快速 更 新 版 本 ， 注 重新 功能 的 实现 ， 而 不 是 稳定 
性 。 本 章 使 用 当前 版 本 。 





1. 在 Windows 系 统 上 安装 Node.js 


从 Node.js 网 站 下 载 并 运行 为 Windows 提 供 的 
Node.js 安 装 程 序 。 安 装 Node.js 时 ， 请 确保 将 其 添加 
到 PATH 系统 变量 中 。 图 13-1 显 示 了 Windows 安 装 程 
序 ， 它 提供 了 一 个 安装 选项 ， 可 以 将 Node.js 添 加 到 
PATH 系统 变量 。 





Custom Setup 


Select the way you want features to be installed. N ed e 


Click the icons in the tree below to change the way features will be installed. 


Install the core Node.js runtime 
(node.exe). 


This feature requires 16M8 on your 
han ry 


subfeatures selected. The 
subfeatures require 20KB on your 
hard drive. 





a = 
图 13-1 将 Node.js 添 加 到 PATH 系统 变量 中 
2. 在 macOS 上 安装 Node.js 
可 以 从 Node.js 网 站 下 载 用 于 macOS 的 Node.js 安 


装 程 序 。 运 行 安 装 程 序 并 接受 默认 值 。 安 装 完 成 
后 ， 确 保 /usr/local/bin 位 于 $PATH 中 。 


3. 在 Linux 系 统 上 安装 Node.js 





在 Linux 系 统 上 安装 Node.js 的 最 简单 方法 是 使 
用 包 管 理 器 ，Node.js 团 队 在 Node.js 网 站 上 为 主要 发 
行 厂 提供 了 说 明 。 对 于 Ubuntu 系统 ， 可 使 用 代码 清 


单 13-1 中 的 命令 下 载 并 安装 Node.js。 
代码 清单 13-1 ”安装 Node.js 


sudo curl -sL https***nodesource***/setup_6.x | sudo -E 
bash - 
sudo apt-get install -y nodejs 


13.1.2 检查 Node.js 安 装 状 态 


安装 完成 后 ， 打 开 新 的 命令 提示 符 并 运行 代码 
清单 13-2 所 示 的 命令 ， 检 查 Node.js 是 耕 正 党 工作 ， 
并 显示 已 安装 的 版 本 。 





代码 清单 13-2 检查 Node.js 安 装 状态 


node -v 


如 果 安 装 成 功 并 且 Node.js 已 添加 到 PATH 系统 
变量 中 ， 你 将 看 到 版 本 与 。 在 撰写 本 书 时 ，Node.js 
的 当前 版 本 古 6.11.2。 在 根据 本 章 中 的 示例 执行 操 
作 时 如 果 遇 到 问题 ， 可 答 试 使 用 这 个 特定 版 本 。 











13.1.3 ”安装 Git 


Visual Studio Code 已 经 集成 了 Git 文 持 ， 但 还 需 
要 单独 安装 Git 以 文 持 Bower 工 具 ， 用 于 管理 客户 端 
软件 包 。 











1. 在 Windows 系 统 或 macOS 上 安装 Git 
你 可 从 git-scm 网 站 下 载 并 运行 安装 程序 。 
2. 在 Linux 系 统 上 安装 Git 


大 多 数 Linux 系 统 中 已 经 安装 了 Git。 如 果 你 仍 
想 单 独 安装 Git， 请 参阅 git-scm 网 站 上 的 发 行 版 安装 
说 明 。 对 于 Ubuntu 系统 ， 使 用 代码 清单 13-3 所 示 的 


命令 安装 Git。 


代码 清单 13-3 ”在 Ubuntu 系统 上 安装 Git 


sudo apt-get install git 


13.1.4 检查 Git 安 装 状 态 


完成 安装 后 ， 在 新 的 命令 提示 和 从 或 Terminal 中 
运行 代码 清单 13-4 所 示 的 命令 ， 检查 Git 是 否 已 安装 
日 可 用 。 





代码 清单 13-4 ”检查 Git 安 装 状态 


git --version 


以 上 命令 会 输出 已 安装 的 Git 版 本 。 在 撰写 本 
书 时 ， 用 于 Windows 系 统 和 macOS 的 最 新 版 本 的 Git 
是 2.14.1， 用 于 Linux 系 统 的 最 新 版 本 的 Git 是 2.7.4。 


13.1.5 ”安装 Bower 


Node.js}? J Node Package 
Manager (NPM) ， 用 于 下 载 和 安装 使 用 JavaScript 
编写 的 软件 包 。 本 章 所 需 的 唯一 软件 包 是 Bower,， 
它 用 于 管理 客户 端 软件 包 ， 第 6 章 对 此 进行 了 说 








上 明 。 运 行 代码 清单 13-5 所 示 的 命令 ， 为 Windows 系 
统 下 载 并 安装 Bower。 


代码 清单 13-5 “在 Windows 系 统 上 安装 Bower 


npm install -g bowerQ1.8.6 


对 于 Linux 系 统 和 macOS， 可 使 用 相同 的 命 
令 ， 但 需要 sudo， 如 代码 清单 13-6 所 示 。 


代码 清单 13-6 ”在 Linux 系 统 或 macOS 上 安装 Bower 


sudo npm install -g bower@1.8.0 


13.1.6 ”安装 ,NET Core 


ASP.NET Core MVC 开 发 需要 .NET Core 运 行 
时 。 每 个 受 文 持 的 平台 都 有 目 己 的 安装 过 程 ， 参 见 
Microsoft 官 网 。 微 软 提 供 了 用 于 Windows 系 统 和 
macOS 的 安装 程序 ， 并 使 用 tar 存 档 提 供 Linux 系 统 
下 的 安装 命令 。 





1. 在 Windows 系 统 和 macOS 上 安装 .NET Core 


要 在 Windows 系 统 或 macOS 上 安装 .NET Core, 
只 需要 下 载 并 运行 .NET Core SDK 安 装 程序 即 可 。 


2. 在 Linux 系 统 上 安装 .NET Core 





微软 在 其 官网 上 提供 了 在 最 沉 行 的 Linux 发 行 
版 上 安装 .NET Core 的 说 明 。 本 章 使 用 的 是 
Ubuntu， 首 先 使 用 代码 清单 13-7 所 示 的 命令 为 apt- 
get 设 置 新 的 种 子 。 








代码 清单 13-7 准备 在 Ubuntu Linux 系 统 上 安装 .NET Core 


sudo sh -c ‘echo "deb [arch=amd64] *****://apt-mo.traff 
icmanager. ***/repos/dotnet-release/ 
xenial main" > /etc/apt/sources.list.d/dotnetdev.list' 


sudo apt-key adv --keyserver ***://keyserver.ubuntu. *** 
:80 --recv-keys 417AQ893 
sudo apt-get update 





下 一 步 是 安装 .NET Core， 如 代码 清单 13-8 所 


人 小。 


代码 清单 13-8 在 Ubuntu Linux 系 统 上 安装 .NET Core 


sudo apt-get install dotnet-sdk-2.0.0 


13.1.7 检查 .NET Core 安 装 状 态 


无 论 使 用 何 种 平台 ， 都 可 以 检查 .NET Core 是 
个 已 安装 并 可 以 使 用 。 打 开 新 的 命令 提示 人 符 或 
Terminal 并 运行 代码 清单 13-9 所 示 的 命令 。 


代码 清单 13-9 检查 .NET Core 版 本 


dotnet 命 令 会 启动 .NET 运 行 时 ， 并 显示 已 安装 
的 .NET Core 的 版 本 号 。 在 撰写 本 书 时 ， 当 前 版 本 
是 2.0.0， 但 是 到 你 阅读 本 书 时 ， 可 能 已 经 有 更 新 的 
版 本 了 。 


13.1.8 ”安装 Visual Studio Code 


最 重要 的 一 步 是 下 载 并 安装 Visual Studio 
Code， 安 装 包 可 从 Visual Studio 官 网 获得 。 安 装 包 
可 用 于 Windows 系 统 、macOS 和 流行 的 Linux 系 统 发 
行 版 。 下 载 并 安 猴 所 选 平台 的 安装 包 。 


YO 
vy DA 
YE Je 


微软 每 个 月 都 会 发 布 新 版 的 Visual Studio 
Code， 这 意味 着 你 安装 的 版 本 可 能 会 与 本 书 的 版 本 
不 同 。 虽 然 基 本 原理 保持 不 变 ， 但 这 意味 着 可 能 需 
要 进行 一 些 党 试 才 能 完成 本 章 中 的 一 些 示 例 。 


1. 在 Windows 系 统 上 安装 Visual Studio Code 


要 在 Windows 系 统 上 安装 Visual Studio Code， 
运行 安 儿 程序 即 可 。 完 成 安装 过 程 后 ， 
Visual Studio Code 将 启动 ， 你 将 看 到 编辑 器 窗口 ， 
如 图 13-2 所 示 。 





2. 在 macOS 上 安装 Visual Studio Code 


Visual Studio Code 可 作为 Mac 计 算 机 的 zip 存 档 
提供 ， 可 以 从 Microsoft 官 网 下 载 。 展 开 存 档 ， 然 后 
双击 其 中 包含 的 Code.app 文 件 用 于 启动 Visual Studio 
Code， 和 生成 图 13-2 所 示 的 编辑 占 和 窗口。 


3. 在 Linux 系 统 上 安装 Visual Studio Code 


微软 为 Debian 和 Ubuntu 系统 提供 了 .deb 文 件 ， 
为 Red Hat 系 统 、Fedora 系 统 和 CentOS 提 供 了 .rpm 文 
件 。 下 载 并 安装 适用 于 对 应 Linux 发 行 版 的 文件 。 
由 于 本 章 使 用 的 是 Ubuntu 系 统 ， 因 此 下 载 .deb 文 件 





并 使 用 Ubuntu 软 件 工具 进行 安装 。 


安装 完成 后 ， 运 行 代码 清单 13-10 所 示 的 命令 
以 启动 Visual Studio Code， 生 成 图 13-2 所 示 的 编辑 
av fi HO o 


代码 清单 13-10 ”在 Linux 系 统 上 启动 Visual Studio Code 


/usr/share/code/code 








图 13-2 ”在 Windows 系 统 、macOS 和 Ubuntu Linux 系 统 上 运行 
Visual Studio Code 


13.1.9 检查 Visual Studio Code 安 装 状 态 


成 功 安装 Visual Studio Code 后 ， 就 可 以 启动 应 
用 程序 并 得 看 编辑 器 了 (这 里 更 改 了 配色 方案 ， 
为 默认 的 深 色 主题 不 适合 图 书 出 版 ) 。 








13.1.10 ”安装 Visual Studio Code 的 C# 扩 展 





Visual Studio Code 通 过 扩展 来 文 持 特 定 于 语言 
的 功能 ， 但 这 些 扩展 与 Visual Studio 支 持 的 扩展 不 
同 。 对 ASP.NET Core MVC 开 发 而 言 最 重要 的 扩展 
是 增加 对 C# 的 文 持 ， 这 看 起 来 像 是 粗心 的 遗漏 ， 但 
反映 了 如 下 事实 : 微软 已 将 Visual Studio Code 定 位 
为 文 持 尽 可 能 广泛 的 语言 和 框 织 的 通用 路 平台 编 辑 
AF o 


HCH 展 ， 请 单 击 Visual Studio Codet O 
左 侧 的 Extensions 图 标 。 在 搜索 框 中 输入 csharp， 在 
列表 中 找到 C# for Visual Studio Code 扩 展 ， 如 图 13- 
3 所 示 。 





图 13-3 ”找到 C# for Visual Studio Code 扩 展 


单 击 Install 按 钮 ，Visual Studio Code 将 下 载 并 
安装 扩展 。 单 击 Enable 按 钮 重新 启动 Visual Studio 
Code 并 启用 for Visual Studio Code 扩 展 ， 如 图 13-4 所 
不 。 


图 13-4 Ja ACH fe 
13.2 & Zt ASP.NET Code 项 目 


Visual Studio Code 没 有 集成 创建 ASP.NET Core 
项 目的 功能 ， 但 可 以 使 用 dotnet 命 令 行 创建 新 项 


创建 正确 的 文件 夹 结 构 以 正确 设置 项 目 非常 重 
要 ， 尤 其 是 在 使 用 单元 测试 时 。 在 合适 的 位 置 创建 
名 为 InvitesProjects 的 项 目 。 





接 下 来 ， 在 InvitesProjects 文 件 夹 中 创建 一 个 名 
为 PartyInvites 的 文件 来， 使 用 命令 提示 符 导 航 到 该 
文件 夹 并 运行 代码 清单 13-11 所 示 的 命令 。 


代码 清单 13-11 在 PartyInvites 文 件 夹 中 创建 一 个 新 的 项 目 


dotnet new web --language C# --framework netcoreapp2.@ 


dotnet new 命 令 能 够 以 命令 行 的 方式 访问 项 目 
模板 ， 代 码 清单 13-11 指 定 的 web 模板 对 应 于 前 面 章 
节 中 使 用 的 Visual Studio Empty 模板 。 表 13-1 描 述 了 
可 用 于 ASP.NET Core 开 发 的 一 组 项 目 模板 〈 其 他 模 
板 也 是 可 用 的 ， 但 它们 不 适用 于 ASP.NET Core。 运 





行 dotnet new --help 命 令 可 人 查看 完整 列表 ) 。 


表 13-1 用 于 ASP.NET Core 开 发 的 dotnet new 模 板 












































这 是 前 面 章 节 中 使 用 的 Empty 模板 ， 用 于 创建 ASP.NET Core 项 目 ， 但 是 没有 启 月 
MVC 框 架 

















这 是 第 2 章 中 使 用 的 Web Application(Model-View-Controller) 模 板 ， 用 于 创建 包 
MVC 框 架 、 占 位 符 控制 器 和 视图 的 ASP.NET Core 项 目 




















it | 这 是 xUnit Test Project (.NET Core) 模板 ， 可 使 用 xUnit 包 设置 单元 测试 








13.3 ”使 用 Visual Studio Code 准 备 项 目 


要 在 Visual Studio Code 中 打开 项 目 ， 请 从 File 
H dh Open Folder， 导 航 到 InvitesProjects 项 目 
文件 夹 ， 然 后 单 击 Select Folder 按 钮 。Visual Studio 
Code 将 打开 项 目 并 目 动 安装 编辑 和 调试 C# 应 用 程序 
所 需 的 一 些 软件 包 。 第 一 次 开始 编辑 文件 几 秒 后 ， 
你 将 看 到 一 条 消 轧 ， 提 示 将 一 些 资源 添加 到 项 目 





中 ， 如 图 13-5 所 示 。 





图 13-5 “提示 将 资源 添加 到 项 目 中 


单 击 Yes 按 钮 ，Visual Studio Code 将 创 

建 .vscode 文 件 夹 并 添加 一 些 用 于 配置 构建 过 程 的 文 
件 。 默 认 情 况 下 ，Visual Studio Code 使 用 包含 3 个 
区 域 的 布局 。 侧 栏 (在 图 13-6 中 己 框 选 ) 提供 对 主 
要 功能 区 域 的 访问 。 顶 层 的 按钮 用 于 打开 资源 管理 
幽 窗 格 ， 显 示 已 打开 文件 夹 的 内 容 。 其 他 按钮 提供 
对 搜索 功能 、 集 成 源 代 码 管 理 、 调 试 右 和 已 安装 扩 
展 集 的 访问 。 












4 InvitesProjects — Visual Studio Code 
on View Go Debug Tasks Help 
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图 13-6 Visual Studio Code 的 边栏 


单 击 资源 管理 器 窗 格 中 的 文件 ， 即 可 打开 并 进 
行 编辑 。Visual Studio Code 文 持 同 时 编辑 多 个 文 
件 ， 可 以 通过 单 击 窗口 右上 角 的 Split Editor 按 钮 来 
创建 新 的 编辑 器 窗 格 。Visual Studio 代 码 编辑 器 相 
当 不 错 ， 在 输入 NuGet 和 Bower 软 件 包 的 名 称 和 版 
本 时 ， 可 以 提供 良好 的 智能 感知 文 持 。 


除 项 目 文 件 夹 中 的 内 容 之 外 ， 资 源 管理 器 窗 格 
会 显示 当前 正在 编辑 的 文件 ， 这 使 你 可 以 轻松 地 








将 注意 力 集 中 在 正在 使 用 的 文件 集 上 ， 这 在 处 理 大 
型 项 目 中 的 相关 文件 子 集 时 非常 有 用 。 











13.3.1 He Pere 


Bower 用 于 管理 Visual Studio Code 项 目 中 的 客 
户 端 软 件 包 ， 就 像 在 Visual Studio 中 一 样 ， 但 是 还 
需要 做 一 些 额 外 的 工作 。 


第 一 步 是 添加 一 个 名 为 .bowerrc 的 文件 ， 议 文 
件 用 于 告诉 Bower 在 哪里 安装 软件 包 。 碳 击 
PartyInvites 文 件 夹 ， 从 弹出 这 单 中 选择 New File, 
创建 新 文件 ， 如 图 13-7 所 示 。 





4 INVITESPROJECTS 


We ieee We 


AAA? 








rey y 
图 13-7 创建 新 文件 
将 文件 名 设置 为 .bowerrc (请 注意 ， 文 件 名 中 
有 两 个 r) 并 添加 代码 清单 13-12 所 示 的 内 容 。 
代码 清单 13-12 .bowerrc 文 件 的 内 容 


{ 
} 


"directory": "wwwroot/1lib" 





接 下 来 ， 创 建 一 个 名 为 bower.json 的 文件 ， 并 
添加 代码 清单 13-13 所 示 的 内 容 。 


代码 清单 13-13 ”bower.json 文 件 的 内 容 


"name": "“PartyInvites", 
"private": true, 
"dependencies": { 


"bootstrap": "4.0.0-alpha.6" 
} 





} 


使 用 命令 提示 符 或 Terminal 在 PartyInvites 文 件 
夹 中 运行 代码 清单 13-14 所 示 的 命令 ， 从 而 使 用 
Bower 工 具 下 载 并 安装 bower.json 文 件 中 指定 的 客户 
站 软件 包 。 








代码 清单 13-14 “安装 客户 端 软件 包 
13.3.2 ”配置 应 用 程序 


项 目的 初始 化 过 程 会 创建 一 个 不 文 持 MVC 的 
空 项 目 。 代 码 清单 13-15 显 示 了 如 何 使 用 最 基本 配 





置 在 Startup.cs 文 件 中 这 加 对 MVC 的 文 持 ， 其 中 的 语 
句 将 在 第 14 草 中 进行 摘 述 。 


using 
using 
using 
using 
using 
using 
using 
using 





代码 清单 13-15 ”在 Startup.cs 文 件 中 添加 对 MVC 的 支持 


System; 

System.Collections.Generic; 

System. Ling; 

System. Threading.Tasks; 
Microsoft.AspNetCore. Builder; 
Microsoft.AspNetCore.Hosting; 
Microsoft.AspNetCore.Http; 
Microsoft.Extensions.DependencyInjection; 


namespace PartyInvites { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 


n services) { 


services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages() ; 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 





13.3.3 ”构建 和 运行 项 有 目 


要 构建 和 运行 项 目 ， 请 在 PartyInvites 目 录 中 运 
行 代 码 清单 13-16 所 示 的 命令 。 








代码 清单 13-16 ”运行 应 用 程序 


Visual Studio Code 将 编译 项 目 中 的 代码 ， 并 使 
用 第 14 章 描述 的 Kestrel 应 用 程序 服务 器 来 运行 应 用 
程序 ， 等 待 端口 5000 上 的 HTTP 请 求 。 





Visual Studio Code 不 支持 检测 C# 类 文件 发 生 的 
更 改 ， 因 此 在 进行 更 改 时 必须 俘 止 应 用 程序 并 再 次 
JAZ) 


要 测试 应 用 程序 ， 请 使 用 浏览 器 导航 到 
http://localhost: 5000。 你 将 看 到 网 13-8 所 示 的 啊 
应 ， 显 示 404 错 误 是 因为 项 目 中 没有 控制 希 用 来 处 





理 请 求 。 








图 13-8 测试 示例 应 用 程序 


13.4 重新 创建 PartyInvites 应 用 程序 


所 有 准备 工作 都 已 完成 ， 这 意味 看 可 以 将 注意 
力 转移 到 创建 MVC 应 用 程序 。 这 里 将 从 第 2 章 开 始 
重新 创建 简单 的 PartyInvites 应 用 程序 ， 但 需要 进行 
一 些 更 改 以 重点 展示 如 何 使 用 Visual Studio Code. 


13.4.1 创建 模型 和 存储 库 


请 右 击 PartyInvites 文 件 夹 ， 然 后 从 弹出 有 亲 单 中 
选择 New Folder， 创 建新 文件 严 ， 如 图 13-9 所 示 。 
将 文件 夹 的 名 称 设置 为 Models。 


“4 Startup.cs — InvitesProjects — Visual Studio Code 





File Edit Selection View Go Debug Tasks Help 
EXPLORER 你 | 
4 OPEN EDITORS 1 using System; 
TREE 2 using System.Collections.Gene 
3 using System.Ling; 4 
多 bowerjson 
~ a using System. Threading. Tasks; 


© Startup.cs Partyinvites 


using 


Microsoft ee 


4 INVITESPROJECTS D> i o @ 6 using Microsoft.AspNetCore.Ho, 
> .vscode 7 using Microsoft.AspNetCore.Htt 
8 using Microsoft.Extensions.De 
4 Partyinvites - : 
> bin New File f 
ace PartyInvites { 
> obj New Folder 


Reveal in Explorer 








blic class Startup { 


© .bowerr Open in Command Prompt public wid Configurese 
services .AddMvc()x 
& bower,js } 
S Partyinv Find in Folder 
Cr Progran Copy public void Configure 
C Startup app -UseDeveloperE 
app-UseStatusCode! 
Copy Path app.UseStaticFil 
app .UseMvcWithDef, 
Rename } s 
Delete 3 
À 
= A a ans 
Pe a i Oe ppp AAA 


图 13-9 ”创建 新 文件 夹 
右 击 资源 管理 器 中 的 Models 文 件 来， 从 弹出 朋 
单 中 选择 New File， 将 文件 名 设置 为 
GuestResponse.cs， 然 后 添加 代码 清单 13-17 所 示 的 
C# 代 码 。 


使 用 Visual Studio Code 编 辑 器 


Visual Studio Code (以 及 本 章 前 面 安装 的 C# 扩 
E) 为 C# 文 件 以 及 JavaScript、CSS 和 普通 HTML 文 
件 等 常见 Web 格 式 提 供 了 完整 的 编辑 体验 。 在 
Visual Studio Code 中 编写 MVC 应 用 程序 与 使 用 
Visual Studio 编 辑 器 有 很 多 共同 点 ， 如 智能 感知 文 
持 、 代 码 着 色 和 高 亮 显 示 错 误 〈 以 及 提供 修复 建 


议 ) 等 。 


Visual Studio Code 的 主要 缺点 是 缺乏 目 定 义 功 
能 ， 特 别 是 在 格式 化 代码 时 。 在 写作 本 书 时 ， 还 有 
其 他 语言 可 用 的 配置 选项 ， 但 C 硅 展 没有 提供 上 自 定 
义 功能 。 如 果 你 喜欢 的 编码 规范 不 是 默认 文 持 的 ， 
那么 C# 扩 展 可 能 有 点 难以 使 用 。 但 总 的 来 说 ， 编 辑 
器 啊 应 迅速 且 易 于 使 用 ， 在 macOS 或 Linux 系 统 上 
编写 MVC 应 用 程序 的 体验 并 不 差 。 





代码 清单 13-17 ”PartyInvites/Models 文 件 夹 下 的 
GuestResponse.cs 文 件 的 内 容 


using System.ComponentModel .DataAnnotations; 
namespace PartyInvites.Models { 
public class GuestResponse { 
public int id {get; set; } 
[Required(ErrorMessage = "Please enter your nam 
e")] 


public string Name { get; set; } 


[Required(ErrorMessage = "Please enter your ema 
il address") ] 


[RegularExpression(".+\\@.+\\..+", 
ErrorMessage = "Please enter a valid email 
address") ] 
public string Email { get; set; } 


[Required(ErrorMessage = "Please enter your pho 
ne number") ] 
public string Phone { get; set; } 


[Required(ErrorMessage = "Please specify whethe 
r you'll attend") ] 
public bool? WillAttend { get; set; } 


} 





接 下 来 ， 将 名 为 IRepository.cs 的 文件 添加 到 
Models 文 件 夹 中 ， 并 用 它 定 义 代码 清单 13-18 所 示 
的 接口 。 本 章 中 的 应 用 程序 与 第 2 章 中 的 应 用 程序 
之 间 最 重要 的 区 别 是 将 模型 数据 存储 在 持久 化 数据 
库 中 。IRepository 接 口 擅 述 了 应 用 程序 如 何 访问 模 
型 数据 而 不 指定 实现 。 








代码 清单 13-18 ”PartyInvites/Models 文 件 夹 下 的 IRepository.cs 
文件 的 内 容 


using System.Collections.Generic; 


namespace PartyInvites.Models { 


public interface IRepository { 
IEnumerable<GuestResponse> Responses {get; } 


void AddResponse(GuestResponse response) ; 


} 





} 


将 一 个 名 为 ApplicationDbContext.cs 的 文件 添加 
到 Models 文 件 严 中， 并 用 它 定 义 数据 库 上 下 文 类 ， 





如 代码 清单 13-19 所 示 。 


代码 清单 13-19 ”PartyInvites/Models 文 件 夹 下 的 
ApplicationDbContext.cs 文 件 的 内 容 


using Microsoft.EntityFrameworkCore; 


namespace PartyInvites.Models { 
public class ApplicationDbContext : DbContext { 
public ApplicationDbContext() {} 


protected override void OnConfiguring(DbContext 
OptionsBuilder builder) { 
builder.UseSqlite("Filename=./PartyInvites. 
db"); 
} 


public DbSet<GuestResponse> Invites {get; set;} 





SQLite 将 数据 存储 在 由 上 下 文 类 指定 的 文件 
中 。 对 于 示例 应 用 程序 ， 数 据 将 存储 在 名 为 
PartyInvites.db 的 文件 中 ， 访 文件 定义 在 
OnConfiguring 方 法 中 。 


要 完成 存储 和 访问 模型 数据 所 需 的 类 ， 需 要 实 
现 数据 库 上 和 下文 类 的 IRepository 接 口 。 将 名 为 
EFRepository.cs 的 新 文件 添加 到 Models 文 件 夹 中 ， 
并 添加 代码 清单 13-20 所 示 的 代码 。 


代码 清单 13-20 ”PartyInvites/Models 文 件 夹 下 的 EFRepository.cs 
文件 的 内 容 


using System.Collections.Generic; 


namespace PartyInvites.Models { 
public class EFRepository : IRepository { 


private ApplicationDbContext context = new Appl 
icationDbContext(); 


public IEnumerable<GuestResponse> Responses => 
context.Invites; 


public void AddResponse(GuestResponse response) 


context.Invites.Add(response) ; 
context .SaveChanges(); 





EFRepository 类 使 用 与 第 8 划 中 对 应 的 类 似 模 式 


来 设置 SportsStore 数 据 库 。 人 代码 清单 13-21 在 Startup 

类 的 ConfigureServices 方 法 中 添加 了 一 条 配置 语 

句 ， 该 方法 告诉 ASP.NET 在 依赖 注入 功能 要 求实 现 

IRepository 接 口 时 创建 EFRepository 类 (参考 第 18 

E) 。 

代码 清单 13-21 在 PartyInvites 文 件 夹 下 的 Startup.cs 文 件 中 配置 
存储 库 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using PartyInvites.Models; 


namespace PartyInvites { 
public class Startup { 
public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddTransient<IRepository, EFReposi 
tory>(); 
services.AddMvc(); 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 





13.4.2 ”创建 数据 库 








在 本 书 的 其 他 部 分 ， 每 当 需 要 演示 数据 持久 化 
功能 时 ， 都 会 使 用 LocalDB，LocalDB 是 Microsoft 
SQL Server 的 简化 版 本 。 但 是 LocalDB 仪 在 Windows 
平台 上 可 用 ， 这 意味 着 在 其 他 平台 上 创建 ASP.NET 
Core MVC 应 用 程序 时 需要 蔡 代 方案 。LocalDB 的 最 
佳 蔡 代 方 案 是 SQLite，SQLite 是 路 平台 的 并 且 无 须 
配置 的 数据 库 ， 可 以 散 入 应 用 程序 中 。 在 通常 与 
ASP.NET Core MVC 应 用 程序 一 起 使 用 的 数据 访问 
层 Entity Framework Core 中 ， 微 软 已 默认 包含 对 
SQLite 的 支持 。 接 下 来 介绍 将 SQLite 添 加 到 项 目 中 











并 将 其 作为 数据 存储 的 过 程 。 


使 用 SQLite 进 行 开发 


LocalDB 是 一 个 非常 有 用 的 工具 ， 原 因 之 一 是 
它 允 许 使 用 SQL Server 数 据 库 引 苟 进 行 开发 ， 这 使 
Í$ SQL Server 生 产 环境 的 过 渡 变 得 非常 简单 而 且 
基本 没有 风险 。SQLite 也 是 优秀 的 数据 库 ， 但 它 不 
适合 大 规模 的 Web 应 用 程序 ， 这 童 味 着 在 部 车 MVC 
应 用 程序 时 需要 转换 到 男 一 个 数据 库 。 使 用 第 14 半 
描述 的 项 目 配置 功能 可 以 简化 配置 更 改 ， 但 是 需要 
在 蜀 存 坏 境 中 彻底 测试 应 用 程序 ， 以 显示 生产 数据 
库 引 入 的 任何 差异 。 


如 果 不 确 定 是 否 在 生产 环境 中 使 用 SQLite， 请 
参阅 SQLite 官 网 ， 上 面 提供 了 有 关 SQLite 的 优势 及 
缺陷 的 介绍 。 


需要 注意 的 一 个 问题 是 ，Entity Framework 
Core 可 以 为 其 他 数据 库 生 成 完整 的 架构 更 改 ， 但 
SQLite 并 不 支持 这 个 功能 。 在 开发 中 使 用 SQLite 
时 ， 这 通常 不 是 问题 ， 因 为 可 以 删除 数据 库 文件 并 
HPT EMAAR FIP TOC TF. (Ave, WREE 
使 用 SQLite 部 署 应 用 程序 ， 则 确实 会 使 问题 复杂 
人 








如 有 果 要 在 开发 和 生产 中 使 用 相同 的 数据 库 ， 请 
参阅 readthedocs 网 站 上 受 Entity Framework Core 文 持 
的 数据 库 列表 。 在 写作 本 书 时 这 个 列表 还 很 短 ， 但 
微软 已 经 宣布 支持 比 SQLite 更 适合 部 署 的 数据 库 ， 
而 且 也 可 以 在 非 Windows 平 侣 上 运行 。 





1. 添加 数据 库 包 


必须 手动 将 包含 创建 和 应 用 数据 库 迁 移 命 令 行 
工具 的 NuGet 包 添加 到 项 目 中 。 打 开 
PartyInvites.csproj 文 件 并 添加 代码 清单 13-22 所 示 的 
Tua: 


代码 清单 13-22 ”将 NuGet 包 添加 到 PartyInvites 文 件 夹 下 的 
PartyInvites.csproj 文 件 中 


<Project Sdk="Microsoft.NET.Sdk.Web"> 


<PropertyGroup> 
<TargetFramework>netcoreapp2.0</TargetFramework> 
</PropertyGroup> 


<ItemGroup> 
<Folder Include="wwwroot\" /> 
</ItemGroup> 


<ItemGroup> 
<PackageReference Include="Microsoft.AspNetCore.All 
" Version="2.0.0" /> 
<DotNetCliToolReference Include="Microsoft.EntityFr 
ameworkCore.Tools .DotNet" 
Version="2.0.0" /> 
</ItemGroup> 


</Project> 





保存 更 改 ， 并 在 PartyInvites 文 件 夹 中 运行 代码 
清单 13-23 所 示 的 命令 ， 以 确保 下 载 并 安装 新 的 软 
件 包 


代码 清单 13-23 ”安装 NuGet 包 


2. 创建 和 应 用 数据 库 迁 移 


创建 数据 库 与 Visual Studio 使 用 的 过 程 相同 。 
要 创建 数据 库 迁 移 ， 请 在 PartyImvites 文 件 夹 中 运行 
代码 清单 13-24 所 示 的 命令 。 


代码 清单 13-24 创建 数据 库 迁移 


dotnet ef migrations add Initial 


Entity Framework Core 将 创建 一 个 名 为 
Migrations 的 文件 来 ， 其 中 包含 将 用 于 设置 数据 库 
染 构 的 C# 类 。 要 应 用 数据 库 迁 移 ， 请 在 PartyInvites 


文件 夹 中 运行 代码 清单 13-25 所 示 的 命令 ， 从 而 在 
PartyInvites 文 件 夹 中 创建 数据 库 。 


代码 清单 13-25 ”应 用 数据 库 迁 移 


dotnet ef database update 


Visual Studio Code 不 支持 查看 SQLite 数 据 库 ， 
但 可 以 在 sqlitebrowser 网 站 上 找到 适用 于 Windows 系 
统 、macOS 和 Linux 系 统 的 优秀 开源 工具 。 


13.4.3 创建 控制 器 和 视图 


在 本 节 中 ， 将 控制 器 和 视图 添加 到 应 用 程序 
中 。 首 先 创建 PartyInvites/Controllers 文 件 夹 并 添加 
一 个 名 为 HomeController.cs 的 文件 ， 用 来 创建 代码 
消 单 13-26 所 示 的 控制 占 


代码 清单 13-26 ”PartyInvites/Controllers 文 件 夹 下 的 
HomeController.cs 文 件 的 内 容 





using System; 

using Microsoft.AspNetCore.Mvc; 
using PartyInvites.Models; 
using System.Ling; 


namespace PartyInvites.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) => 
this.repository = repo; 


public ViewResult Index() { 
int hour = DateTime.Now.Hour; 
ViewBag.Greeting = hour < 12 ? "Good Mornin 
g" : "Good Afternoon" ; 
return View("MyView" ) ; 


} 


[HttpGet] 
public ViewResult RsvpForm() => View(); 


[HttpPost] 
public ViewResult RsvpForm(GuestResponse guestR 
esponse) { 
if (ModelState.IsValid) { 
repository.AddResponse(guestResponse) ; 
return View("Thanks", guestResponse) ; 
} else { 
// there is a validation error 
return View(); 


} 
} 


public ViewResult ListResponses() => 


View(repository.Responses.Where(r => r.Will 
Attend == true)); 


} 





为 了 设置 内 置 的 标签 助 手 ， 创 建 
PartyInvites/Views 文 件 夹 ， 并 添加 一 个 名 为 
_ViewImports.cshtml 的 文件 ， 其 中 包含 代码 清单 13- 
27 所 示 的 代码 。 


代码 清单 13-27 PartyInvites/Views 文 件 夹 下 的 
_ViewImports.cshtml 文 件 的 内 容 


@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 


fee BOK, fii) % PartyInvites/Views/Home X {F 
夹 ， 并 添加 一 个 名 为 MyView.cshtml 的 文件 ， 作 为 
代码 清单 13-26 中 Index 操 作 方 法 选择 的 视 岁 ， 其 中 
的 内 容 如 代码 清单 13-28 所 示 。 





代码 清单 13-28 ”PartyInvites/Views/Home 文 件 夹 下 的 
MyView.cshtml 文 件 的 内 容 


@{ 
} 


<!DOCTYPE html> 


Layout = null; 


<html> 
<head> 

<meta name="viewport" content="width=device-width" 
/> 

<title>Index</title> 

<link rel="stylesheet" href="/1lib/bootstrap/dist/cs 


s/bootstrap.css" /> 
</head> 
<body class="p-2"> 
<div class="text-center"> 


<h3>We're going to have an exciting party! </h3> 
<h4>And you are invited</h4> 
<a class="btn btn-primary" asp-action="RsvpForm 
">RSVP Now</a> 
</div> 
</body> 
</html> 





在 PartyInvites/Views/Home 文 件 夹 中 添加 一 个 
名 为 RsvpForm.cshtml 的 文件 ， 并 添加 代码 清单 13- 
29 上 所 示 的 内 容 。 这 个 视图 用 于 提供 受 邀 者 填写 的 
HTML 表 单 ， 以 便 他 们 接受 或 拒绝 聚会 邀请 。 





代码 清单 13-29 ”PartyInvites/Views/Home 文 件 夹 下 的 


RsvpForm.cshtml 文 件 的 内 容 





@model PartyInvites.Models.GuestResponse 


@{ 

Layout = null; 
} 
<!DOCTYPE html> 
<html> 
<head> 


<meta name="viewport" content="width=device-width" 
/> 
<title>RsvpForm</title> 
<link rel="stylesheet" href="/1ib/bootstrap/dist/cs 
s/bootstrap.css" /> 
</head> 
<body> 
<div class="m-2"> 
<div class="text-center"><h4>RSVP</h4></div> 
<form class="p-1" asp-action="RsvpForm" method= 


"post"> 
<div asp-validation-summary="All"></div> 
<div class="form-group"> 
<label asp-for="Name">Your name:</label 
> 
<input class="form-control" asp-for="Na 
me" /> 
</div> 
<div class="form-group" > 
<label asp-for="Email">Your email:</lab 
el> 


<input class="form-control" asp-for="Em 
ail" /> 


</div> 
<div class="form-group" > 
<label asp-for="Phone">Your phone:</lab 
el> 
<input class="form-control" asp-for="Ph 
one" /> 
</div> 
<div class="form-group" > 
<label>Will you attend?</label> 
<select class="form-control" asp-for="W 
illAttend"> 


<option value="">Choose an option</ 


option> 
<option value="true">Yes, I'll be t 
here</option> 
<option value="false">No, I can't c 
ome< /option> 
</select> 
</div> 
<div class="text-center"> 
<button class="btn btn-primary" type="s 
ubmit"> 
Submit RSVP 
</button> 
</div> 
</form> 
</div> 
</body> 
</html> 





下 一 个 视图 文件 名 为 Thanks.cshtml， 也 创建 在 
PartyInvites/Views/Home 文 件 夹 中 ， 内 容 如 代码 清 





单 13-30 所 示 ， 当 来 宾 提 交 啊 应 时 将 显示 这 个 视 
图 。 


代码 清单 13-30 PartyInvites/Views/Home 文 件 夹 下 的 
Thanks.cshtml 文 件 的 内 容 





@model PartyInvites.Models.GuestResponse 


@{ 

Layout = null; 
} 
<!DOCTYPE html> 
<html> 
<head> 


<meta name="viewport" content="width=device-width" 
/> 
<title>Thanks</title> 
<link rel="stylesheet" href="/1ib/bootstrap/dist/cs 
s/bootstrap.css" /> 
</head> 
<body class="text-center"> 
<p> 
<hi>Thank you, @Model.Name!</h1> 
@if (Model.WillAttend == true) { 
@:It's great that you're coming. The drinks 
are already in the fridge! 
} else { 
@:Sorry to hear that you can't make it, but 
thanks for letting us know. 


} 


</p> 
Click <a asp-action="ListResponses">here</a> 
to see who is coming. 

</body> 

</html> 





最 后 一 个 视图 名 为 ListResponses.cshtml， 与 本 
例 中 的 其 他 视图 一 样 ， 也 添加 到 
PartyInvites/Views/Home 文 件 夹 中 。 这 个 视图 使 用 
代码 清单 13-31 所 示 的 标记 显示 来 宾 啊 应 列表 。 











代码 清单 13-31 ”PartyInvites/Views/Home 文 件 夹 下 的 
ListResponses.cshtml 文 件 的 内 容 





@model IEnumerable<PartyInvites.Models.GuestResponse> 
@{ 
} 


Layout = null; 


<!DOCTYPE html> 
<html> 
<head> 

<meta name="viewport" content="width=device-width" 
/> 

<link rel="stylesheet" href="/1lib/bootstrap/dist/cs 
s/bootstrap.css" /> 

<title>Responses</title> 
</head> 


<body> 
<div class="m-1 p-1"> 
<h2>Here is the list of people attending the pa 
rty</h2> 
<table class="table table-sm table-striped tabl 
e-bordered"> 
<thead> 
<tr><th>Name</th><th>Email</th><th>Phon 
e</th></tr> 
</thead> 
<tbody> 
@foreach (PartyInvites.Models.GuestResp 
onse r in Model) { 
<tr><td>@r.Name</td><td>@r.Email</t 
d><td>@r.Phone</td></tr> 


} 
</tbody> 
</table> 
</div> 
</body> 
</html> 





在 PartyInvites 项 目 中 运行 dotnet run 命 令 以 编译 
项 目 并 启动 ASP.NET Core 运 行 时 。 应 用 程序 启动 
后 ， 可 以 通过 导航 到 http://localhost:5000 来 查看 已 完 
成 的 应 用 程序 ， 如 图 13-10 所 示 。 








图 13-10 ”运行 完成 的 应 用 程序 


13.5 Visual Studio Code 中 的 单元 测试 


使 用 Visual Studio DE 的 过 程 与 
Visual Studio 类 似 。 第 一 步 是 为 单元 测试 创建 单独 
的 项 目 。 ee 
Tests 的 文件 来 ， 并 在 这 个 文件 夹 中 运行 代码 清单 
13-32 所 示 的 命令 ， 以 创建 单元 测试 项 目 。 


代码 清单 13-32 ”创建 单元 测试 项 目 
在 Tests 文 件 严 中 运行 代码 清单 13-33 所 示 的 命 








令 ， 添 加 对 应 用 程序 项 目的 引用 ， 以 引用 其 中 包含 
的 类 用 于 测试 。 





代码 清单 13-33 ”添加 对 应 用 程序 项 目的 引用 
13.5.1 创建 单元 测试 


创建 单元 测试 的 过 程 如 第 7 章 所 述 。 将 一 个 名 
AyHomeControllerTests.csHJZE LAFINI El Tests 90 
夹 中 ， 其 中 的 内 容 如 代码 清单 13-34 所 示 。 


代码 清单 13-34 Tests 文 件 夹 下 的 HomeControllerTests.cs 文 件 
的 内 容 





using System; 

using System.Collections.Generic; 
using PartyInvites.Controllers; 
using PartyInvites.Models; 

using Xunit; 

using Microsoft.AspNetCore.Mvc; 
using System.Ling; 


namespace Tests { 


public class HomeControllerTests { 


[Fact] 
public void ListActionFiltersNonAttendees() { 
//Arrange 
HomeController controller = new HomeControl 
ler(new FakeRepository()); 
// Act 
ViewResult result = controller.ListResponse 
s(); 
// Assert 
Assert.Equal(2, (result.Model as IEnumerabl 
e<GuestResponse>).Count()); 
} 
} 


class FakeRepository : IRepository { 
public IEnumerable<GuestResponse> Responses => 
new List<GuestResponse> { 


new GuestResponse { Name = "Bob", WillA 
ttend = true }, 

new GuestResponse { Name = "Alice", Wil 
lAttend = true }, 

new GuestResponse { Name = "Joe", WillA 


ttend = false } 
}; 


public void AddResponse(GuestResponse response) 


throw new NotImplementedException() ; 





这 是 一 个 标准 的 xUnit 测 试 ， 用 于 检查 Home 控 
制 右 中 的 ListResponses 操 作 ， 并 正确 过 小 存储 库 中 
WillAttend 属 性 为 false 的 GuestResponse 对 象 。 


13.5.2 ZTM 


要 在 项 目 中 运行 单元 测试 ， 请 在 Tests 文 件 夹 中 
运行 代码 清单 13-35 所 示 的 命令 。 
代码 清单 13-35 ”运行 单元 测试 


这 将 运行 项 目 中 的 所 有 测试 并 显示 结果 ， 产 生 
如 下 输出 : 








Starting test execution, please wait... 

[xUnit.net 00:00:00.6731479 | Discovering: Tests 
[xUnit.net 00:00:00.7900132] Discovered: Tests 
[xUnit.net 00:00:00.8432715 | Starting: Tests 
[xUnit.net 00:00:00.9967614 |] Finished: Tests 


Total tests: 2. Passed: 2. Failed: ©. Skipped: @. 
Test Run Successful. 


以 上 结果 显示 有 两 个 测试 ， 因 为 项 目 模板 包含 
一 个 名 为 UnitTestl.cs 的 文件 ， 而 其 中 又 包含 一 个 空 
的 单元 测试 。 可 以 删除 此 文件 ， 如 第 7 章 所 述 。 








13.6 小结 


本 章 人 简要 介绍 了 如 何 使 用 Visual Studio Code, 
它 是 一 个 轻 量 级 的 开发 工具 ， 文 持 在 Windows 系 
统 、macOS 和 Linux 系 统 上 进行 ASP.NET Core MVC 
开发 。Visual Studio Code 还 无 法 成 为 完整 的 Visual 
Studio 产 品 的 蔡 代 品 ， 但 它 提 供 了 创建 MVC 应 用 程 
序 所 需 的 核心 功能 ， 人 微软 每 月 都 会 及 布 更 新 以 增强 
其 功能 。 











本 书 第 一 部 分 到 此 结束 ， 第 二 部 分 将 深入 研究 
ASP.NET Core 的 细节 ， 并 详细 展示 如 何 使 用 这 些 功 
能 来 创建 应 用 程序 。 


第 二 部 分 ASP.NET Core MVC 详 解 








到 目前 为 止 ， 你 已 经 了 解 了 ASP.NET Core 
MVC 存 在 的 原因 ， 并 了 解 了 其 体系 结构 和 压 层 设计 
目标 。 通 过 构建 一 个 真实 的 电子 了 商务 应 用 程序 ， 你 
己 经 掌握 了 测试 驱动 开发 方式 。 现 在 是 时 候 打 开放 
子 并 展示 框架 机 制 的 全 部 细 方 了 。 











本 书 第 二 部 分 将 深入 讨论 细节 。 该 部 分 首先 探 
b} ASP.NET Core MVC 应 用 程序 的 结构 以 及 处 理 请 
求 的 方式 ， 然 后 重点 关注 各 个 功能 ， 例 如 路 由 、 控 
制 妖 和 action、MVC 视 图 和 标签 助手 系统 ， 以 及 将 
MVC 与 域 模 型 一 起 使 用 的 方式 。 





第 14 章 ”配置 应 用 程序 


配置 这 个 主题 似乎 并 不 是 很 有 趣 ， 但 它 揭 示 了 
很 多 MVC 应 用 程序 如 何 工作 以 及 如 何 处 理 HTTP 请 
求 。 你 不 应 该 跳 过 本 章 ， 而 应 该 伦 时 间 了 解 配置 系 
统 构造 MVC Web 应 用 程序 的 方式 ， 从 而 为 理解 后 
面 的 章节 页 定 坚实 的 基础 。 








本 章 将 解释 如 何 配置 MVC 应 用 程序 ， 并 展示 
MVC 如 何 构建 ASP.NET Core 平 台 提 供 的 功能 。 表 
14-1 总 结 了 在 上 下 文中 配置 应 用 程序 时 的 一 些 问 


题 。 








表 14-1 在 上 下 文中 进行 配置 时 的 一 些 问题 

















Program 和 Startup 类 以 及 JSON 文 件 用 于 配置 应 用 程序 的 工作 方式 以 及 依赖 的 
a 






























































配置 系统 允许 应 用 程序 根据 运行 环境 进行 定制 ， 并 管理 依赖 的 















































最 重要 的 组 件 是 Startup 类 ， 它 用 于 创建 服务 〈 在 整个 应 用 和 
功能 的 对 象 )》 和 中 间 件 〈 用 于 处 理 HTTP 请 求 ) 


















































有 任何 问题 或 
限制 吗 ? 














在 复杂 的 应 用 程 









































还 有 其 他 选择 


吗 ? 








没有 。 配 置 系统 是 ASP.NET 和 MVC 应 用 程序 设置 方式 的 组 成 部 分 
































表 14-2 列 出 了 本 章 要 介绍 的 操作 。 


表 14-2 本章 要 介绍 的 操作 





















































代码 清单 14-5 一 代码 
清单 14-8 









































程序 添加 功能 将 NuGet 包 添加 到 .csproj 文 件 
































代码 清单 14-9 一 代码 
清单 14-11 






































EASP.NET 应 用 程序 的 初始 化 | 使 用 Program 类 




















使 用 Startup 类 的 ConfigureServices | 代码 清单 14-12 和 代 
和 Configure 方 法 码 清单 14-13 


















































创建 通用 功能 



























































在 其 他 中 间 件 处 理 请 求 之 前 编辑 
请 求 











其 他 中 间 件 处 理 的 响应 




















MVC 功 能 























为 不 同 环境 改变 应 用 程序 配置 















































F 发 期 间 管理 多 个 浏览 





启用 图 像 、JavaScript 文 件 和 CSS 
文件 





从 C# 代 码 中 分 离 配置 数据 





使 用 ConfigureServices 方 法 创建 


创建 响应 编辑 


使 月 























E 成 中 间 件 








中 间 件 














有 UseMvc 或 
UseMvcWithDefaultRoute 方 法 


托管 环境 服务 





使 月 





H 









































发 环境 或 生产 环境 钳 





理 中 间 件 


日 浏览 器 链接 








创建 外 部 配置 源 ， 例 如 JSON 文 件 








中 间 件 








误 处 

















代码 清 上 




















fais 5 
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E 









































代码 清 上 




















码 清和 








14-14 一 代 


14-16 


单 14-17 一 代 
14-19 


14-20 和 代 


和 14-21 


14-22 一 代 


和 14-24 














E 








































































































Sie 























a5 
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代码 清 























14-25 和 代 


f.14-26 


14-29 和 代 


114-30 


14-33 一 代 





码 清单 14-35 


























i 单 14-36 一 代 
人 码 清 单 14-38 



































记录 中 间 件 

















准备 依赖 注入 以 与 Entity 
Framework Core 一 起 使 用 






































用 范围 验证 







































































配置 MVC 服 务 使 用 选项 功能 代码 清单 14-40 
Hays 14-41 ~ 
更 用 多 个 外 部 文件 或 类 人 上 
码 清 单 14-45 


14.1 准备 示例 项 目 






















































































本 章 中 ， 我 们 将 使 用 Empty 模板 创建 一 个 名 为 
ConfigureApps 的 新 项 目 。 稍 后 将 配置 应 用 程序 ， 但 
是 在 做 出 更 改 之 前 ， 首 先 需要 做 一 些 基 本 的 准备 工 
dee 





我 们 将 在 本 章 中 使 用 Bootstrap 来 设置 HTML 内 
容 的 样式 ， 因 此 使 用 Bower Configuration File 模 板 
创建 bower.json 文 件 ， 并 添加 代码 清单 14-1 所 示 的 





包 。 


代码 清单 14-1 在 ConfiguringApps 文 件 严 下 的 bower.json 文 件 
中 添加 Bootstrap 


{ 


"name": "asp.net", 
"private": true, 
"dependencies": { 
"bootstrap": "4.0@.0-alpha.6" 
} 
} 





接 下 来 ， 创 建 Controllers 文 件 夹 并 添加 一 个 名 
为 HomeController.cs 的 类 文件 ， 用 来 定义 代码 清单 
14-2 FT ANY £2 will a o 


AAS 14-2 ”Controllers 文 件 夹 下 的 HomeController.cs 文 件 的 
内 容 





using System.Collections.Generic; 
using Microsoft.AspNetCore.Mvc; 


namespace ConfiguringApps.Controllers { 


public class HomeController : Controller { 


public ViewResult Index() => View(new Dictionar 
y<string, string> { 
["Message"] = "This is the Index action 


上 万 





接 下 来 ， 创 建 Views 人 /Home 文 件 夹 并 添加 一 个 
名 为 Index.cshtml 的 视图 文件 ， 其 中 的 内 容 如 代码 清 
单 14-3 所 示 。 


代码 清单 14-3 ”Views/Home 文 件 夹 下 的 Index.cshtml 文 件 的 内 


IP 


谷 





@model Dictionary<string, string> 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 

<meta name="viewport" content="width=device-width" 
/> 

<link asp-href-include="1lib/bootstrap/dist/css/*.mi 
n.css" rel="stylesheet" /> 

<title>Result</title> 
</head> 
<body class="p-1"> 

<table class="table table-condensed table-bordered 
table-striped"> 


@foreach (var kvp in Model) { 


<tr><th>@kvp.Key</th><td>@kvp.Value</td></t 
r> 


} 
</table> 
</body> 
</html> 





IR APA link 7038 HORT A ELEN op 25 BP Ra 
择 Bootstrap CSS 文 件 。 为 了 局 用 内 置 的 标签 助手 ， 
可 使 用 MVC View Imports Page 模 板 来 创建 Views 文 
件 夹 中 的 _ViewImports.cshtml 文 件 ， 并 添加 代码 清 
单 14-4 所 示 的 代码 。 





代码 清单 14-4 Views 文 件 夹 下 的 _ViewImports.cshtml 文 件 的 内 


IP 


局 动 应 用 程序 ， 你 将 看 到 如 图 14-1 所 示 的 消 





[M locathost:6541 
é C |© localhost654 


Hello World! 





图 14-1 运行 示例 应 用 程序 
14.2 配置 项 目 


最 重要 的 配置 文件 是 <projectname>.csproj， 以 
取代 早期 版 本 的 ASP.NET Core 中 使 用 的 project.json 
文件 。 这 个 文件 在 示例 项 目 中 名 为 
InstallingApps.csproj, Visual Studio 隐 藏 了 该 文件 ， 
必须 通过 右 击 Solution Explorer 窗 格 中 的 项 目 并 从 弹 
出 的 集 单 中 选择 Edit ConfiguringApps.csproj 来 访 
问 。 人 代码 清单 14-5 显 示 了 ConfigureApps.csproj 文件 
的 初始 内 容 ， 该 文件 由 Visual Studio 作 为 Empty 项 目 
模板 的 一 部 分 创建 。 





代码 清单 14-5”ConfiguringApps 文 件 夹 下 的 
ConfigureApps.csproj 文 件 的 内 容 


<Project Sdk="Microsoft.NET.Sdk.Web"> 


<PropertyGroup> 
<TargetFramework>netcoreapp2.0</TargetFramework> 
</PropertyGroup> 


<ItemGroup> 
<Folder Include="wwwroot\" /> 
</ItemGroup> 


<ItemGroup> 
<PackageReference Include="Microsoft.AspNetCore.All 
" Version="2.0.0" /> 
</ItemGroup> 


</Project> 





.csproj X} Fi MSBuild LE, MSBuild L 
上 共用 于 构建 .NET 项 目 。 使 用 XML 元 素 执行 配置 ， 
表 14-3 摘 述 了 默认 配置 文件 中 的 元 素 。 尽 管 我 们 在 
后 面 的 示例 中 使 用 了 其 他 配置 元 素 ， 但 表 14-3 中 的 
元 素 对 于 开发 ASP.NET Core MVC 项 目 已 经 足够 
Ts 


表 14-3 ”默认 .csproj 文 件 中 的 XML 配置 元 素 





元 素 述 
























































been 此 为 根 元 素 ， 表 示 这 是 一 个 MSBuild 配 置 文件 。Sdk 属 性 被 设置 为 
rojec 

| Microsoft.NET.Sdk.Web， 以 导入 构建 项 目 所 需 的 隐 式 包 
PropertyGroup 此 元 素 将 相关 配置 属性 ， 以 将 结构 添加 到 文件 


此 元 素 指 定 构 建 过 程 所 针对 的 .NET Framework 版 本 ， 必 须 在 
TargetFramework | PropertyGroup 元 素 中 定义 。 默 认 值 为 netcoreapp2.0， 以 .NET Core 2.0 为 
标 
































此 元 素 将 相关 配置 项 分 组 ， 以 将 结构 添加 到 文件 
ae 此 元 素 告 诉 MSBuild 如 何 处 理 项 目 中 的 文件 来。 列表 中 的 元 素 告诉 
older 
MSBuild 在 发 布 应 用 程序 时 应 包含 wwwroot 文 件 夹 


此 元 素 用 于 指定 NuGet 包 的 依赖 项 ，NuGet 包 可 通过 Include 和 Version 属 
PackageReference | 性 进行 标识 。IMicrosoft.AspNetCore.All 包 用 于 提供 对 所 有 ASP.NET Core 
和 MVC Framework 功 能 的 访问 





































































































14.2.1 将 包 添 加 到 项 目 中 


.CSproj 文 件 最 重要 的 作用 是 列 出 项 目 所 依赖 的 

X Visual Studio 检 测 到 对 .csproj 文 件 进 行 的 更 改 
时 ， 它 会 检查 包 的 列表 ， 下 载 新 添加 的 内 容 ， 并 删 
除 所 有 不 再 需要 的 包 


tii ASP.NET Core 2 的 发 布 ，ASP.NET Core 
MVC、MVC 框 架 和 Entity Framework Core 所 需 的 所 
有 基本 功能 都 包含 在 Microsoft.AspNetCore.All 元 数 
据 包 中 。 这 是 一 个 很 方便 的 功能 ， 避 人 免 了 开始 狐 项 
目 时 需要 问 项 目 添加 一 长 串 NuGet 包 的 问题 。 





即便 如 此 ， 也 需要 为 第 三 方 或 高 级 功 和 nae 
NuGet 包 。 有 3 种 方法 可 以 将 包 添 加 到 项 目 中 。 
种 是 选择 Tools > NuGet Package Manager — Manage 
NuGet Packages for Solution， 可 以 通过 人 简单 方便 的 
界面 管理 NuGet 包 。 如 果 你 不 熟悉 .NET 开 用 ， 那 么 
文 是 最 好 的 方法 ， 因 为 它 可 以 减少 选择 包 时 出 错 的 
可 能 性 。 





例如 ， 要 添加 System.Net.Http 包 ， 这 个 包 提 供 
了 创建 《〈 不 仅仅 是 接收 )》 HTTP 请 求 的 文 持 ， 可 以 
转 到 包 管 理 右 的 Browse 部 分 ， 按 名 称 搜索 ， 并 得 看 
可 用 版 本 的 完整 列表 ， 包 括 任何 预 发 布 版 本 ， 如 图 





14-2 所 示 。 


Manage Packages for Solution 
Package source: nuget.or -| & 


上 图 System.Net.Http 
v43. 
Version(3 0 
5 ; 





图 14-2 ”使 用 NuGet 包 管理 器 添加 包 


第 二 种 方法 是 选择 所 需 的 软件 包 和 版 本 ， 然 后 
选择 需要 软件 包 的 项 目 ， 单 击 Install 按 钮 ，Visual 
Studio 将 下 载 软件 包 并 更 新 .csproj 文 件 。 





最 后 一 种 方法 是 使 用 命令 行 添 加 包 ， 但 需要 知 

包 的 名 称 《〈 理 想 情 况 下 还 需要 知道 版 本 ) 。 代 码 

清单 14-6 显 示 了 在 ConfiguringApps 文 件 严 中 运行 的 
用 于 将 System.Net.Http 包 添加 到 项 目 中 。 


代码 清单 14-6 ”将 包 添 加 到 项 目 中 


dotnet add package System.Net .Http --version 4.3.2 


NuGet 包 管理 器 和 dotnet add package 命 令 都 会 
C Ai 中 。 如 果 
， 可 以 编辑 配置 文件 ， 通 过 手动 添加 
PackageReference 包 。 这 是 最 直接 的 方 
法 ， 但 需要 注意 避免 错误 输入 包 的 名 称 或 指定 不 存 
在 的 版 本 号。 在 代码 清单 14-7 中 ， 可 以 看 到 为 了 添 
加 System.Net.Http 包 对 .csproj 文 件 所 做 的 修改 。 








代码 清单 14-7 在 ConfiguringApps 文 件 夹 下 的 
InstallingApps.csproj 文 件 中 添加 包 





<Project Sdk="Microsoft.NET.Sdk.Web"> 


<PropertyGroup> 
<TargetFramework>netcoreapp2.0</TargetFramework> 
</PropertyGroup> 
<ItemGroup> 
<Folder Include="wwwroot\" /> 
</ItemGroup> 


<ItemGroup> 
<PackageReference Include="Microsoft.AspNetCore.All 
" Version="2.0.0" /> 
<PackageReference Include=" System.Net .Http”Version 
="4.3.2" /> 
</ItemGroup> 








PackageReference 元 素 包 含 用 于 指定 包 名 称 的 
Include 属 性 和 用 于 指定 版 本 写 的 Version 属 性 。 


14.2.2 ”将 工具 包 添 加 到 项 目 中 





虽然 能 够 以 不 同 的 方式 还 加 第 规 包 ， 但 是 茶 些 
包 扩 展 了 dotnet 命 令 行 工具 的 功能 ， 这 些 包 需 
要 .csproj 文 件 中 的 不 同类 型 的 元 际 ， 比 如 
DotNetCliToolReference 元 素 ， 而 不 是 由 应 用 程序 直 
接 使 用 的 包 所 需 的 PackageReference 元 素 。 因 此 ， 
只 能 通过 直接 编辑 .csproj 文 件 将 这 些 包 添加 到 项 目 
中 。 








代码 清单 14-8 旺 示 了 添加 的 包 ， 人 允许 使 用 本 书 


一 部 分 使 用 的 dotnet ef 命令 创建 和 应 用 数据 库 迁 


。 


代码 清单 14-8 将 工具 包 添 加 到 ConfiguringApps 文 件 夹 下 的 
InstallingApps.csproj 文 件 中 


<Project Sdk="Microsoft.NET.Sdk.Web"> 


<PropertyGroup> 
<TargetFramework>netcoreapp2.0</TargetFramework> 
</PropertyGroup> 


<ItemGroup> 
<Folder Include="wwwroot\" /> 
</ItemGroup> 


<ItemGroup> 
<PackageReference Include="Microsoft.AspNetCore.All 
" Version="2.0.0" /> 
<PackageReference Include="System.Net.Http" Version 
="4.3.2" /> 
<DotNetCliToolReference Include="Microsoft.EntityFr 
ameworkCore. Tools .DotNet" 
Version="2.0.0 " /> 
</ItemGroup> 


</Project> 





在 将 工具 包 添 加 a 到 项 目 中 时 ， 可 以 将 





DotNetCliToolReference 元 素 包 含 在 与 常规 
PackageReference 元 素 相 同 的 ItemGroup 中 ， 如 代码 
清单 14-8 所 示 ， 或 创建 单独 的 ItemGroup 元 素 。 将 更 
改 保存 到 .csproj 文 件 时 ，Visual Studio 将 下 载 并 安装 
软件 包 ， 然 后 使 用 它们 来 配置 domet 命 令 行 工具 。 





14.3 ”理解 Program 类 





Program 类 定义 在 名 为 Program.cs 的 文件 中 ， 并 
提供 运行 应 用 程序 的 入 口 点 。Program 类 为 .NET 提 
供 了 Main 方 法 ， 可 以 执行 Main 方 法 来 配置 托管 环境 
并 选择 完成 ASP.NET Core 应 用 程序 的 配置 类 。 
Program 关 的 默认 内 容 足 以 文 持 大 多 数 项 目的 局 动 
和 运行 ， 代 码 清单 14-9 显 示 了 Visual Studio 添 加 到 
项 目 中 的 默认 代码 。 





代码 清单 14-9 ”ConfiguringApps 文 件 夹 下 的 Program.cs 文 件 的 
默认 内 容 


uSing System; 

using System.Collections.Generic; 

using System. IO; 

using System. Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.Configuration; 
using Microsoft.Extensions.Logging; 


namespace ConfiguringApps { 
public class Program { 


public static void Main(string[] args) { 
BuildWebHost(args).Run(); 


} 


public static IWebHost BuildWebHost(string[] ar 
gs) => 
WebHost.CreateDefaultBuilder(args) 
.UseStartup<Startup>() 
.Build(); 





Main 方 法 提供 了 所 有 .NET 应 用 程序 必须 提供 
的 入 口 点 ， 以 便 运 行 时 可 以 执行 它们 。Program 类 
中 的 Main 方 法 会 调用 BuildWebHost 方 法 ， 
BuildWebHost 方 法 则 负责 配置 ASP.NET Core. 


BuildWebHost 方 法 使 用 WebHost 类 定义 的 静态 
方法 来 配置 ASP.NET Core。 随 着 ASP.NET Core 2 的 
发 布 ， 可 通过 使 用 CreateDefaultBuilder 方 法 简化 配 
置 ， 访 方法 使 用 适合 大 多 数 项 目的 设置 来 配置 
ASP.NET Core。 可 调用 UseStartup 方 法 以 标识 特定 
于 应 用 程序 的 配置 类 ， 但 约定 是 使 用 名 为 Startup 的 
类 ， 详 情 将 在 本 音 后 面 介 绍 。Bnuild 方 法 处 理 所 有 配 
置 并 创建 一 个 实现 了 IWebHost 接 口 的 对 象 ， 然 后 返 
回 给 Main 方 法 ，Main 方 法 调用 Run 以 开始 处 理 
HTTP 请 求 。 





深入 配置 细 市 


CreateDefaultBuilder 方 法 是 一 种 快速 启动 
ASP.NET Core 配 置 的 便捷 方法 ， 但 它 确 实 隐藏 了 许 
多 重要 细 和 ， 如 果 需 要 更 改 应 用 程序 的 配置 方式 ， 
这 可 能 会 是 一 个 问题 。 代 码 清单 14-10 将 


CreateDefaultBuilder 方 法 蔡 换 成 了 调用 创建 默认 配 








置 的 单条 语句 。 


代码 清单 14-10 ”ConfiguringApps 文 件 夹 下 的 Program.cs 文 件 中 
的 详细 配置 语句 








using System; 

using System.Collections.Generic; 

using System. IO; 

using System. Linq; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.Configuration; 
using Microsoft.Extensions. Logging; 

using System.Reflection; 


namespace ConfiguringApps { 
public class Program { 


public static void Main(string[] args) { 
BuildWebHost(args).Run(); 


} 
public static IWebHost BuildWebHost(string[] ar 
gs) { 
return new WebHostBuilder() 
.UseKestrel() 
.UseContentRoot (Directory.GetCurrentDir 
ectory()) 


. ConfigureAppConfiguration((hostingCont 
ext, config) => { 
var env = hostingContext.HostingEnv 


ironment; 
config.AddJsonFile("appsettings.jso 
n", optional: true, 
reloadOnChange: true) 
.AddJsonFile($"appsettings. {env 
.EnvironmentName}.json", 
optional: true, reloadOnCha 
nge: true); 


if (env.IsDevelopment()) { 
var appAssembly = 
Assembly.Load(new AssemblyN 
ame(env.ApplicationName) ) ; 
if (appAssembly != null) { 
config.AddUserSecrets(appAs 
sembly, optional: true); 
} 
} 


config.AddEnvironmentVariables() ; 


if (args != null) { 
config .AddCommandLine(args) ; 
} 
}) 
.ConfigureLogging((hostingContext, logg 
ing) => { 
logging. AddConfiguration( 
hostingContext.Configuration.Ge 
tSection("Logging") ); 
logging.AddConsole(); 
logging .AddDebug() ; 
}) 
.UseIISIntegration() 
.UseDefaultServiceProvider( (context 
» options) => { 


options.ValidateScopes = 


context .HostingEnvironment. 
IsDevelopment() ; 


}) 
.UseStartup<Startup>() 


.Build(); 





表 14-4 列 出 了 添加 到 BuildWebHost 方 法 的 所 有 
配置 方法 ， 并 提供 相应 功能 的 简要 说 明 。 


表 14-4 ”添加 到 BuildWebHost 方 法 的 所 有 配置 方法 


eb 服务 
用 于 配置 应 用 程序 的 根 目 录 ， 根 目录 用 于 加 载 配 
静态 内 容 ， 如 图 像 、JavaScript 和 CSS 

























































































UseContentRoot 












































tween eRe 


于 在 代码 文件 之 外 存储 敏感 数据 。 这 是 一 个 有 点 环 手 的 方 
法 ， 本 书 没 有 使 用 

















AddUserSecrets 



































ConfigureLogging 用 于 配置 应 用 程序 的 日 志 记 录 






































UseIISIntegration 用 于 启用 与 IIS 和 IIS Express 的 集成 
UseDefaultServiceProvider | 用 于 配置 依赖 注入 












































UseStartup 指定 将 用 于 配置 ASP.NET 的 类 


代码 清单 14-10 已 经 解释 了 一 些 更 复杂 的 语 
句 。 现 在 ， 删 除 一 些 配 置 语 句 ， 只 保留 基本 配置 ， 
如 代码 清单 14-11 所 示 。 


代码 清单 14-11 ”简化 ConfiguringApps 文 件 夹 下 的 Program.cs 文 


件 中 的 配置 





using 
using 
using 
using 
using 
using 
using 
using 
using 
using 


System; 

System.Collections.Generic; 

System. IO; 

System. Ling; 

System. Threading.Tasks; 
Microsoft.AspNetCore; 
Microsoft.AspNetCore.Hosting; 
Microsoft. Extensions.Configuration; 
Microsoft.Extensions.Logging; 
System.Reflection; 


namespace ConfiguringApps { 
public class Program { 


public static void Main(string[] args) { 
BuildWebHost(args).Run(); 
} 


public static IWebHost BuildWebHost(string[] ar 
gs) { 


return new WebHostBuilder() 
.UseKestrel() 
.UseContentRoot (Directory.GetCurrentDir 
ectory()) 


.UseIISIntegration() 
.UseStartup<Startup>() 
.Build(); 








这 些 语句 提供 了 适用 于 大 多 数 ASP.NET Core 
MVC 应 用 程序 的 基本 配置 。 当 解释 其 他 语句 的 功能 
时 ， 再 把 它们 添加 回来 。 


直接 使 用 Kestrel 


Kestrel] 是 路 平台 的 Web 服 务 器 ， 则 在 运行 


ASP.NET Core 应 用 程序 。 当 使 用 IIS 

Express (Visual Studio 提 供 的 在 开发 期 间 使 用 的 服 
Sat) 或 完整 版 IS (.NET 应 用 程序 的 传统 Web 平 
台 ) 运行 ASP.NET Core 应 用 程序 时 ， 会 自动 使 用 

Kestrel. 





如 有 和 需要， 也 可 以 直接 运行 Kestrel， 这 意味 看 
可 以 在 任何 文 持 的 平台 上 运行 ASP.NET Core MVC 
应 用 程序 ， 绕 过 IIS 仪 广 持 Windows 平 台 的 限制 。 有 
两 种 方法 可 以 使 用 Kestrel 运 行 应 用 程序 。 可 以 单 击 
Visual Studio 工 具 栏 上 IIS Express 按 钮 右边 缘 的 箭 
头 ， 然 后 选择 与 项 目 名 称 匹 配 的 选项 。 这 将 打开 一 
个 新 的 命令 提示 符 并 使 用 Kestrel 运 行 应 用 程序 。 








也 可 以 通过 以 下 方法 实现 相同 的 效果 : 打开 命 
令 提 示 符 ， 导 航 到 包含 应 用 程序 配置 文件 的 文件 夹 
(包含 .csproj 文 件 的 那个 文件 夹 ) 并 运行 以 下 命 


默认 情况 下 ，Kestrel 服 务 器 开始 在 端口 5000 上 
侦 听 HITTP 请 求 。 如 果 项 目 中 有 
Properties/launchSettings.json 文 件 ， 束 从 这 个 文件 中 
该 取 应 用 程序 的 HITP 端 口 和 环境 。 





14.4 了 解 Startup 关 


Program 类 负责 局 动 应 用 程序 ， 但 最 重要 的 配 
置 工作 是 通过 UseStartup 方 法 委派 的 ， 如 下 所 示 : 


.UseStartup<Startup>() 


iu type 参 数 来 标识 用 于 配置 
ASP.NET Core 的 类 。 RAN) i PL PK Ze Startup, 
Startup tł ASP.NET Core koa 目 模 板 〈 包 括 用 





于 为 本 章 创 建 示 例 项 目的 Empty 模板 ) 使 用 的 名 
称 。 


研究 Startup 类 的 工作 原理 可 以 帮助 你 深入 了 解 
HTTP 请 求 的 处 理 方式 ， ne 
ASP.NET Core 平 台 的 其 余音 





在 本 节 中 ， 将 从 最 简单 的 Startup 类 开始 ， 并 添 
加 功能 以 演示 不 同 配置 选项 的 效果 ， 最 后 使 用 适合 
大 多 数 MVC 项 目的 配置 。 作 为 起 点 ， 代 码 清单 14- 
as J Visual Studio 添 加 到 Empty 项 目 中 的 Startup 
这 里 为 该 类 设置 了 足够 的 功能 以 使 ASP.NET 
Core 能 够 处 理 HTTP 请 求 。 








代码 清单 14-12 ”Startup.cs 文 件 的 初始 内 容 





using System; 

using System.Collections.Generic; 
using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 
using Microsoft.AspNetCore.Hosting; 


using Microsoft.AspNetCore.Http; 
using Microsoft.Extensions.DependencyInjection; 


namespace ConfiguringApps { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 


if (env.IsDevelopment()) { 
app.UseDeveloperExceptionPage(); 


} 


app.Run(async (context) => { 
await context.Response.WriteAsync( "Hell 


o World!"); 





Startup 类 定义 了 两 个 方法 一 一 
ConfigureServices 和 Configure， 它 们 用 于 设置 应 用 
程序 所 需 的 共享 功能 ， 并 告诉 ASP.NET Core 应 该 如 
何 使 用 它们 。 








当 应 用 程序 启动 时 ，ASP.NET Core 会 创建 一 个 
新 的 Startup 实 例 并 调用 ConfigureServices 方 法 ， 以 
便 应 用 程序 可 以 创建 服务 。 正 如 14.4.1 市 所 解释 
的 ， 服 务 是 为 应 用 程序 其 他 部 分 提供 功能 的 对 象 。 














以 上 描述 过 于 模糊 ， 因 为 服务 可 以 用 来 提供 任 
何 功能 。 创 建 服务 后 ，ASP.NET 将 调用 Configure 方 
法 。Configure 方 法 的 目的 是 设置 请 求 管道 ， 请 求 管 
道 是 一 组 组 件 一 一 称 为 中 间 件 一 一 用 于 处 理 传 入 的 
HTTP 请 求 并 为 它们 生成 啊 应 。 其 中 解释 请 求 管 道 
的 工作 原理 ， 并 演示 如 何在 14.4.2 市 中 创建 中 间 
件 。 图 14-3 显 示 了 ASP.NET 使 用 Startup 类 的 方式 。 











图 14-3 ”ASP.NET 如 何 使 用 Startup 类 配置 应 用 程序 


让 Startup 美 为 所 有 请 求 返 回 相 同 的 *Hello， 


World” 消 息 是 没有 意义 的 ， 所 以 在 详细 解释 类 中 的 
方法 之 前 ， 需 要 先 启用 MVC， 如 代码 清单 14-13 所 
示 。 





代码 清单 14-13 ”在 ConfiguringApps 文 件 夹 下 的 Startup.cs 文 件 
中 启用 MVC 


using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace ConfiguringApps { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseMvcWithDefaultRoute() ; 





后 面 的 章 贡 会 解释 这 些 修 改 ， 现 在 已 经 有 足够 
的 基础 设施 代码 来 处 理 HTTP 请 求 并 使 用 控制 器 和 
视图 生成 啊 应 了 。 如 果 运 行 应 用 程序 ， 你 将 看 到 图 
14-4 所 示 的 输出 。 











图 14-4 局 用 MVC 的 效果 


请 注意 ， 输 出 的 内 容 尚 未 设置 样式 。 代 码 清单 
14-13 中 的 最 小 配置 不 支持 提供 静态 内 容 ， 如 CSS 样 
式 表 和 JavaScript 文 件 ， 因 此 当 Index.cshtml 视 网 文 
件 中 的 link 元 素 请 求 Bootstrap CSS 样 式 时 ， 应 用 程 
序 无 法 处 理 ， 导 致 浏览 喜 无 法 获取 所 需 的 CSS 样 
式 。14.4.4 节 将 介绍 如 何 解决 这 个 问题 。 





14.4.1 了 解 ASP.NET 服 务 


ASP.NET Core il J Startup.ConfigureServices /7 
法 ， 以 便 应 用 程序 可 以 设置 所 需 的 服务 。 服 务 是 指 
为 应 用 程序 的 其 他 部 分 提供 功能 的 对 象 。 如 上 所 
述 ， 这 样 的 摘 述 过 于 模糊 ， 因 为 服务 可 以 执行 应 用 
程序 所 需 的 任何 操作 。 举 例 来 说 ， 在 项 目 中 添加 
Infrastructure 文 件 夹 ， 并 在 其 中 添加 一 个 名 为 
UptimeService.cs 的 类 文件 ， 用 来 定义 代码 清单 14- 
14 所 示 的 类 。 








代码 清单 14-14 ”Infrastructure 文 件 夹 下 的 UptimeService.cs 文 件 
的 内 容 





using System.Diagnostics; 


namespace ConfiguringApps.Infrastructure { 


public class UptimeService { 
private Stopwatch timer; 


public UptimeService() { 
timer = Stopwatch.StartNew() ; 


} 


public long Uptime => timer.ElapsedMilliseconds 


;| 
} 

创建 UptimeService 类 时 ，UptimeService 构 造 函 
数 会 局 动 一 个 计时 器 ， 以 跟踪 应 用 程序 的 运行 时 
间 。 这 是 一 个 很 好 的 服务 示例 ， 因 为 它 提供 了 可 以 
在 应 用 程序 的 其 他 部 分 使 用 的 功能 ， 并 且 可 以 在 应 
用 程序 启动 时 创建 。 





ASP.NET 服 务 使 用 Startup 类 的 
ConfigureServices 方 法 来 注册 ， 在 代码 清单 14-15 
中 ， 可 以 看 到 如 何 注册 UptimeService 类 。 


代码 清单 14-15 ”在 ConfiguringApps 文 件 严 下 的 Startup.cs 文 件 
中 注册 自 定 义 服 务 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


using ConfiguringApps.Infrastructure; 


namespace ConfiguringApps { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services .AddSingleton<UptimeService>() ; 
services.AddMvc(); 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseMvcWithDefaultRoute() ; 





作为 参数 ，ConfigureServices 方 法 会 接收 实现 
了 IServiceCollection 接 口 的 对 象 。 可 使 用 在 
IServiceCollection 接 口上 调用 的 扩展 方法 注册 服 
务 ， 这 些 扩展 方法 指定 了 不 同 的 配置 选项 。 第 18 章 
将 描述 可 用 于 创建 服务 的 选项 ， 但 目前 使 用 了 
AddSingleton 方 法 ， 这 意味 着 整个 应 用 程序 将 共享 
一 个 UptimeService 对 象 。 





服务 与 依赖 注入 功能 密切 相关 ， 后 者 允许 控制 
颖 等 组 件 轻松 获取 服务 ， 这 将 在 第 18 章 深入 介绍 。 
在 Startup.ConfigureServices 中 注册 的 服务 可 以 通过 
创建 接收 参数 的 构造 函数 来 访问 ， 参 数 需 要 为 请 求 
的 服务 类 型 。 代 码 清 单 14-16 显 示 了 添加 到 Home 控 
制 颖 的 构造 疯 数 ， 以 接收 代码 清单 14-15 中 创建 的 
共享 的 UptimeService 对 象 。 这 里 还 更 新 了 控制 颖 的 
Index 操 作 方 法 ， 以 便 在 生成 的 视图 数据 中 包含 服务 
的 Update 属 性 值 。 








代码 清单 14-16 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 访问 服务 





using System.Collections.Generic; 
using Microsoft.AspNetCore.Mvc; 
using ConfiguringApps.Infrastructure; 


namespace ConfiguringApps.Controllers { 


public class HomeController : Controller { 
private UptimeService uptime; 


public HomeController(UptimeService up) => upti 
me = up; 


public ViewResult Index() 
=> View(new Dictionary<string, string> { 
["Message"] = "This is the Index action 


["Uptime"] = $"{uptime.Uptime}ms" 
}); 








SIMVC h Home te til] aK SE PI RAL FEAT TP 
请 求 时 ， 它 会 检查 HomeController 构 造 函 数 并 友 现 
需要 UptimeService 对 象 。 然 后 ，MVC 检 查 已 在 
Startup 类 中 配置 的 服务 集 ， 发 现 已 经 配置 过 
UptimeService， 这 样 下 可 以 将 单 例 UptimeService 对 
象 用 于 所 有 请 求 ， 并 在 创建 HomeController 时 传递 
该 对 象 作 为 构造 函数 参数 。 








虽然 可 以 使 用 更 复杂 的 方式 注册 和 使 用 服务 ， 
但 此 例 演示 了 服务 背后 的 核心 思想 ， 并 说 明了 如 何 
在 Startup 类 中 定义 服务 ， 以 便 定义 整个 应 用 程序 中 
使 用 的 功能 或 数据 。 


如 朱 运 行 应 用 程序 并 请 求 默认 URL， 你 将 看 到 
一 个 啊 应 ， 包 括 目 应 用 程序 局 动 以 来 的 宣 秒 数 ， 
秒 数 是 从 Startup 类 中 创建 的 ed 
的 ， 如 图 14-5 所 示 (严格 来 说 ， 这 是 目 创 建 
UptimeService 服 务 对 象 以 来 的 时 间 ， 但 这 与 应 用 程 
序 的 局 动 时 间 非 常 接近， 不 会 对 本 章 的 目的 产生 任 
何 影响 ) 。 








图 14-5 ”使 用 简单 服务 获得 的 啊 应 


每 次 收 到 对 默认 URL 的 请 求 时 ，MVC 都 会 创 
建 一 个 新 的 HomeController 对 象 ， 并 为 其 提供 共享 
的 UptimeService 对 象 作 为 构造 函数 参数 。 这 允许 
Home 控 制 笑 访问 应 用 程序 的 正常 运行 时 间 ， 而 不 
用 关心 如 何 提 供 或 实现 此 信息 。 


了 解 内 置 的 MVC 服 务 


像 MVC 这 样 的 复业 软件 包 使 用 了 许多 服务 。 
一 些 供 内 部 使 用 ， 另 一 些 为 开 有 人员 提供 功能 。 包 
定义 扩展 方法 ， 在 单个 方法 调用 中 设置 它们 所 需 的 
所 有 服务 。 对 于 MVC， 这 个 方法 名 为 AddMvc， 它 
是 添加 到 Startup 类 以 使 MVC 工 作 的 两 个 方法 之 一 。 





public void ConfigureServices(IServiceCollection servic 
es) { 

services.AddSingleton<UptimeService>(); 

services .AddMvc(); 


} 





这 个 方法 设置 MVC 所 需 的 每 个 服务 ， 无 须 在 
ConfigureServices 方 法 中 使 用 大 量 单个 服务 。 
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Visual Studio 的 智能 感知 功能 将 显示 可 以 在 
ConfigureServices 方 法 中 的 IServiceCollection 对 象 上 
调用 的 其 他 扩展 方法 的 长 列表 。 其 中 一 些 方法 (如 
AddSingleton 和 AddScoped〉 用 于 以 不 同方 式 注册 服 
务 ， 其 他 方法 (如 AddRouting 或 AddCors〉 H T% 
加 已 由 AddMvc 方 法 使 用 的 单个 服务 。 结 朱 是 ， 对 
于 大 多 数 应 用 程序 ，ConfigureServices 方 法 仅 包 含 
少量 自 定 义 服务 (对 AddMvc 方 法 的 调用 〉 以 及 一 
些 可 选 的 语句 来 配置 内 置 服务 ，14.6 市 将 对 此 进行 


描述 。 


14.4.2 ”了解 ASP.NET 中 间 件 


在 ASP.NET Core 中 ， 中 间 件 是 指 用 来 组 合 请 求 
管道 的 组 件 。 请 求 管 道 像 链 一 样 排列 ， 当 新 请 求 到 


达 时 ， 新 请 求 被 传递 给 链 中 的 第 一 个 中 间 件 。 这 个 
中 间 件 检查 请 求 并 决定 是 否 处 理 并 生成 啊 应 ， 也 可 
将 请 求 传递 给 链 中 的 下 一 个 中 间 件 。 人 处 理 完 请 来 
后 ， 将 返回 到 和 客户 问 的 啊 应 沿 链 传 回 ， 这 允许 所 有 
前 面 的 中 间 件 检查 或 修改 啊 应 。 











中 间 件 的 工作 方式 似乎 有 点 奇怪 ， 但 它 允 许 应 
用 程序 组 合 在 一 起 的 方式 具有 很 大 的 灵活 性 。 了 解 
如 何 使 用 中 间 件 来 构建 应 用 程序 非常 重要 ， 尤 其 是 
在 没有 得 到 预期 的 响应 时 。 为 了 解释 中 间 件 系统 的 
工作 原理 ， 下 面 创建 一 些 上 自 定 义 组 件 来 演示 你 将 遇 
到 的 4 种 类型 的 中 间 件 。 














1. 创建 内 容 生 成 中 间 件 








最 重要 的 中 间 件 类 型 用 于 为 客户 端 生 成 内 容 ， 
MVC 就 属于 这 种 类 型 。 为 了 创建 比 MVC 简 单 的 内 
容 生 成 中 间 件 ， 在 Infrastructure 文 件 夹 中 添加 一 个 


名 为 ContentMiddleware.cs 的 类 ， 用 来 定义 代码 清单 
14-17 所 示 的 类 。 


代码 清单 14-17 Infrastructure 文件 夹 下 的 ContentMiddleware.cs 
文件 的 内 容 


using System.Text; 
using System.Threading.Tasks; 
using Microsoft.AspNetCore.Http; 


namespace ConfiguringApps.Infrastructure { 


public class ContentMiddleware { 
private RequestDelegate nextDelegate; 


public ContentMiddleware(RequestDelegate next) 
=> nextDelegate = next; 


public async Task Invoke(HttpContext httpContex 


t) { 
if (httpContext.Request.Path.ToString().ToL 
ower() == "/middleware") { 
await httpContext.Response.WriteAsync( 


"This is from the content middleware", 
Encoding.UTF8) ; 


} else { 
await nextDelegate. Invoke(httpContext) ; 





中 间 件 既 不 实现 接口 ， 也 不 从 公共 基 类 派生 。 
相反 ， 它 们 定义 了 一 个 构造 函数 ， 这 个 构造 函数 接 
收 RequestDelegate 对 象 并 定义 了 Invoke 方 法 。 
RequestDelegate 对 象 表示 链 中 的 下 一 个 中 间 件 ， 当 
ASP.NET 收 到 HTTP 请 求 时 调用 Invoke 方 法 。 





HTTP 请 求 和 返回 给 客户 端的 啊 应 信息 可 通过 
Invoke 方 法 的 HttpContext 参 数 提 供 。 第 17 章 将 摘 述 
HttpContext 类 及 其 属性 ， 但 是 在 本 章 中 ， 只 需要 知 
道 代 码 清单 14-17 中 的 Invoke 方 法 能 够 检查 HTTP 请 
求 并 验证 请 求 是 否 已 发 送 到 /middleware URL 残 可 以 
{o WRA, WIZ mAH RLAR; 如 
果 使 用 了 不 同 的 URL， 束 将 请 求 转发 到 链 中 的 下 一 
个 中 间 件 。 

















请 求 管 道 是 在 Startup 类 的 Configure 方 法 中 设置 
的 。 在 代码 清单 14-18 中 ， 从 示例 应 用 程序 中 删除 
了 MVC 方 法 ， 并 使 用 ContentMiddleware 类 作为 管道 


中 的 唯一 组 件 。 


代码 清单 14-18 在 ConfiguringApps 文 件 严 下 的 Startup.cs 文 件 
中 使 用 自 定 义 中 间 件 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading.Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using ConfiguringApps.Infrastructure; 


namespace ConfiguringApps { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<UptimeService>() ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseMiddleware<ContentMiddleware>(); 





可 使 用 Configure 方 法 中 的 UseMiddleware 扩 展 
方法 注册 目 定义 中 间 件 。UseMiddleware 方 法 使 用 
类 型 参数 来 指定 中 间 件 类 。 这 样 ASP.NET Core 就 可 
以 构建 一 个 将 要 使 用 的 所 有 中 间 件 的 列表 ， 然 后 将 
它们 实例 化 以 创建 链 。 如 果 运 行 应 用 程序 并 请 

求 /middleware URL， 你 将 看 到 图 14-6 所 示 的 结果 。 








图 14-6 ”从 目 定 义 中 间 件 生成 内 容 





图 14-7 展 示 了 使 用 ContentMiddleware 类 创建 的 
中 间 件 管道 。 当 ASP.NET Core 收 到 HTTP 请 求 时 ， 
它 会 将 请 求 传 递 给 Startup 类 中 注册 的 唯一 中 间 件 。 
如 果 UREL 是 /middleware， 组 件 将 生成 结果 ， 返 回 给 
ASP.NET Core 并 发 送 给 客户 端 。 





内 容 生 成 中 间 件 





ASP.NET 





图 14-7 示例 中 间 件 管 违 





如 果 URL 不 是 /middleware,，ContentMiddleware 
类 束 将 请 求 传递 给 链 中 的 下 一 个 中 间 件 。 但 由 于 没 
有 其 他 组 件 ， 因 此 请 求 在 创建 管道 时 到 达 ASP.NET 
Core 提 供 的 后 备 处 理 程 序 ， 后 备 处 理 程序 在 另 一 个 
方 回 上 沿 着 省 道 友 回 请 求 〈《 如 果 能 看 到 其 他 类 型 的 
中 间 件 如 何 工 作 ， 这 个 过 程 就 容易 理解 了 )。 





并 非 只 有 控制 右 能 够 使 用 ConfigureServices 方 
法 中 设置 的 服务 。ASP.NET Core 检 查 中 间 件 类 的 构 
造 水 数 ， 并 使 用 服务 为 已 定义 的 任何 参数 提供 值 。 
代码 清单 14-19 同 ContentMiddleware 类 的 构造 函数 
添加 了 一 个 参数 ， 以 告诉 ASP.NET Core 需 要 一 个 
UptimeService 对 象 。 





代码 清单 14-19 在 Infrastructure 文 件 夹 下 的 
ContentMiddleware.cs 文 件 中 使 用 服务 





using System.Text; 
using System.Threading.Tasks; 
using Microsoft.AspNetCore.Http; 


namespace ConfiguringApps.Infrastructure { 


public class ContentMiddleware { 
private RequestDelegate nextDelegate; 
private UptimeService uptime; 


public ContentMiddleware(RequestDelegate next, 
UptimeService up) { 
nextDelegate = next; 
uptime = up; 


} 


public async Task Invoke(HttpContext httpContex 
t) { 
if (httpContext.Request.Path.ToString().ToL 
ower() == "/middleware") { 
await httpContext.Response.WriteAsync( 
"This is from the content middlewar 


e "+ 
$"(uptime: {uptime.Uptime}ms)", 
Encoding.UTF8) ; 

} else { 

await nextDelegate. Invoke(httpContext) ; 
} 
} 
} 


人 味 着 中 间 件 可 以 共享 通用 功能 
并 避免 代码 重复 。 运 行 应 用 程序 并 请 求 /middleware 
URL， 你 将 看 到 图 14-8 所 示 的 输出 。 











图 14-8 在 目 定 义 中 间 件 中 使 用 服务 





2. 创建 短路 中 间 件 


下 一 关中 pn 内 容 生 成 中 
拦截 它们 ， 用 来 对 管道 处 理 过 程 进行 短路 ， 
是 为 了 优化 性 能 。 代 码 清单 14-20 显 示 了 hn 
Infrastructure 文 件 夹 中 的 名 为 
ShortCircuitMiddleware.cs 的 类 文件 的 内 容 。 


代码 清单 14-20 ”Infrastructure 文 件 夹 下 的 
ShortCircuitMiddleware.cs 文 件 的 内 容 








using System.Ling; 
using System. Threading. Tasks; 
using Microsoft.AspNetCore.Http; 


namespace ConfiguringApps.Infrastructure { 


public class ShortCircuitMiddleware { 
private RequestDelegate nextDelegate; 


public ShortCircuitMiddleware(RequestDelegate n 
ext) => nextDelegate = next; 


public async Task Invoke(HttpContext httpContex 


if (httpContext.Request.Headers[ "User-Agent 
.Any(h => h.ToLower().Contains("edg 


e"))) | 
httpContext.Response.StatusCode = 403; 


} else { 
await nextDelegate. Invoke(httpContext) ; 


这 个 中 间 件 检查 请 求 的 User-Agent 标 头 ， 浏 览 
和 右 使 用 该 标 头 标识 自 刁 。 使 用 User-Agent 标 头 来 标 
识 特定 的 浏览 右 并 不 可 靠 ， 无 法 在 实际 应 用 程序 中 
使 用 ， 但 对 此 例 来 说 已 经 足够 了 。 








使 用 术语 “短路 ”是 因为 这 种 类 型 的 中 间 件 并 不 
总 是 将 请 求 转发 到 链 中 的 下 一 个 中 间 件 。 在 这 种 情 
况 下 ， 如 果 User-Agent 标 头 包 含 术语 edge， 那 么 组 
件 会 将 状态 码 设置 为 403-Forbidden， 并 且 不 将 请 求 
转发 到 下 一 个 中 间 件 。 巾 于 请 求 被 拒绝 ， 因 此 再 由 
其 他 中 间 件 处 理 请 求 是 没有 意义 的 ， 会 不 必要 地 消 
耗 系统 资源 。 相 反 ， 将 请 求 处 理 提 前 终止 ， 同 客户 
端 发 送 403 响 应 。 











中 间 件 按照 Startup 类 中 设置 的 顺序 接收 请 求 ， 
这 意味 着 必须 在 内 容 生成 中 间 件 之 前 设置 短路 中 间 
件 ， 如 代码 清单 14-21 所 示 。 











代码 清单 14-21 ”在 ConfiguringApps 文 件 夹 下 的 Startup.cs 文 件 
中 注册 短路 中 间 件 





using System; 

using System.Collections.Generic; 
using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 


using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using ConfiguringApps.Infrastructure; 


namespace ConfiguringApps { 
public class Startup { 
public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<UptimeService>() ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseMiddleware<ShortCircuitMiddleware>(); 


app.UseMiddleware<ContentMiddleware>(); 








如 果 使 用 Microsoft Edgel) w 453 47 MH FET IF 
请 求 任何 URL， 那 么 你 将 看 到 403 错 误 。 
ShortCircuitMiddleware 组 件 会 包 略 来 目 其 他 浏览 
的 请 求 ， 并 将 请 求 传递 给 链 中 的 下 一 个 中 间 件 ， 这 
意味 着 当 请 求 的 URL 为 /middleware 时 将 生成 响应 。 
将 短路 中 间 件 添加 到 中 间 件 管道 中 ， 如 图 14-9 所 








人 小。 


3. 创建 请 求 编辑 中 间 件 





下 一 类 中 间 件 不 会 生成 啊 应 。 相 反 ， 它 们 会 在 
请 求 到 达 链 中 的 其 他 中 间 件 之 前 更 改 请 求 。 这 种 中 
则 件 主要 用 于 平台 集成 ， 还 可 用 于 准备 请 求 ， 以 便 
后 续 组 件 更 容易 处 理 它们 。 作 为 演示 ， 将 
BrowserTypeMiddleware.cs 文 件 添 加 到 Infrastructure 
文件 夹 中 ， 并 用 它 定 义 代码 清单 14-22 所 示 的 中 间 
age 








短路 中 间 件 内 容 生 成 中 间 件 
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图 14-9 ”在 中 间 件 管道 中 添加 短路 中 间 件 





代码 清单 14-22 Infrastructure 文件 夹 下 的 
BrowserTypeMiddleware.cs 文 件 的 内 容 


using System.Ling; 
using System. Threading. Tasks; 
using Microsoft.AspNetCore.Http; 


namespace ConfiguringApps.Infrastructure { 


public class BrowserTypeMiddleware { 
private RequestDelegate nextDelegate; 
public BrowserTypeMiddleware(RequestDelegate ne 
xt) => nextDelegate = next; 


public async Task Invoke(HttpContext httpContex 
t) { 
httpContext.Items["EdgeBrowser" | 
= httpContext.Request.Headers[ "User-Age 


.Any(v => v.ToLower().Contains("edg 


await nextDelegate.Invoke(httpContext) ; 





这 个 中 间 件 检查 请 求 的 User-Agent 标 头 并 得 找 
术语 edge， 这 表明 请 求 可 和 ins Fa Microsoft Edge} 
览 器 进行 的 。HttpContext 对 象 通 过 Items 属 性 提供 了 
一 个 字典 ， 该 字典 用 于 在 组 件 之 间 传 递 数据 ， 

将 标 头 的 搜索 结果 与 键 EdgeBrowser 一 起 存储 。 





为 了 演示 中 间 件 如 何 协 作 ， 代 人 码 清单 14-23 显 
示 了 ShortCircuitMiddleware 类 ， 它 拒绝 来 自 
Microsoft Edge 浏 览 左 的 请 求 ， 并 根据 
BrowserTypeMiddleware 组 件 生 成 的 数据 做 出 决 俩 。 


代码 清单 14-23 ”与 ShortCircuitMiddleware.cs 文 件 中 的 男 一 个 
中 间 件 协作 





using System.Ling; 
using System. Threading. Tasks; 
using Microsoft.AspNetCore.Http; 


namespace ConfiguringApps.Infrastructure { 


public class ShortCircuitMiddleware { 
private RequestDelegate nextDelegate; 


public ShortCircuitMiddleware(RequestDelegate n 
ext) => nextDelegate = next; 


public async Task Invoke(HttpContext httpContex 


t) { 
if (httpContext.Items["EdgeBrowser"] as boo 
1? == true) { 
httpContext.Response.StatusCode = 403; 
} else { 
await nextDelegate.Invoke(httpContext) ; 


} 


pe 
} 

残 本 质 而 言 ， 编 辑 请 求 中 间 件 需要 放置 在 与 之 
合作 的 或 者 依赖 于 它们 的 中 间 件 之 前 。 在 代码 清单 
14-24 中 ， 将 BrowserTypeMiddleware 类 注册 为 中 间 
件 管道 中 的 第 一 个 中 间 件 。 














代码 清单 14-24 ”在 ConfiguringApps 文 件 夹 下 的 Startup.cs 文 件 
中 注册 中 间 件 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using ConfiguringApps.Infrastructure; 


namespace ConfiguringApps { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<UptimeService>() ; 
services.AddMvc(); 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseMiddleware<BrowserTypeMiddleware>() ; 
app.UseMiddleware<ShortCircuitMiddleware>() 


app.UseMiddleware<ContentMiddleware>() ; 





将 中 间 件 放置 在 中 间 件 管道 的 开始 处 可 确保 在 
其 他 中 间 件 收 到 请 求 之 前 已 对 请 求 进行 了 修改 ， 如 
图 14-10 所 示 。 





请 求 编辑 中 间 件 短路 中 间 件 内 容 生 成 中 间 件 


ASP.NET 
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图 14-10 ”将 请 求 编辑 组 件 添加 到 中 间 件 管道 中 
4. 创建 啊 应 编辑 中 间 件 


最 后 一 类 中 间 件 用 于 对 中 间 件 管道 中 其 他 中 间 
件 生成 的 啊 应 进行 操作 ， 这 对 于 记录 请 求 及 啊 应 的 








详细 信息 或 处 理 错误 非常 有 有 用。 代码 清单 14-25 显 
示 了 ErrorMiddleware.cs 文 件 的 内 容 ， 将 这 个 文件 添 
加 到 Infrastructure 文 件 夹 中 以 演示 此 类 中 间 件 。 





代码 清单 14-25 ”Infrastructure 文 件 夹 下 的 ErrorMiddleware.cs 文 
件 的 内 容 





using System.Text; 
using System.Threading.Tasks; 
using Microsoft.AspNetCore.Http; 


namespace ConfiguringApps.Infrastructure { 


public class ErrorMiddleware { 
private RequestDelegate nextDelegate; 


public ErrorMiddleware(RequestDelegate next) { 
nextDelegate = next; 


} 
public async Task Invoke(HttpContext httpContex 
await nextDelegate.Invoke(httpContext); 
if (httpContext.Response.StatusCode == 403) 
{ 


await httpContext.Response 
.WriteAsync( "Edge not supported", E 
ncoding.UTF8) ; 
} else if (httpContext.Response.StatusCode 


await httpContext.Response 
.WriteAsync("No content middleware 
response", Encoding.UTF8) ; 











这 个 中 间 件 在 通过 中 间 件 管道 并 且 生 成 啊 应 
六 对 请 求 不 感 兴趣 。 如 末 状 态 码 为 403 BK 404, at 
向 响应 添加 描述 性 消息 。 所 有 其 他 响应 都 被 忽略 。 
代码 清单 14-26 显 示 了 如 何在 Startup 类 中 注册 啊 应 编 
辑 中 间 件 。 





代码 清单 14-26 ”在 Startup.cs 文 件 中 注册 啊 应 编辑 中 间 件 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using ConfiguringApps.Infrastructure; 


namespace ConfiguringApps { 


public class Startup { 
public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<UptimeService>() ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseMiddleware<ErrorMiddleware>(); 
app.UseMiddleware<BrowserTypeMiddleware>(); 
app.UseMiddleware<ShortCircuitMiddleware>() 


app.UseMiddleware<ContentMiddleware>(); 





你 可 能 想 知 道 产 生 404 状 态 码 的 原因 ， 因 为 它 
不 是 由 这 里 创建 的 3 个 中 间 件 中 的 任何 一 个 设置 
的 。 答 案 是 ， 这 是 当 请 求 进 入 管道 时 由 ASP.NET 配 


置 的 啊 应 ， 如 果 没 有 中 间 件 更 改 啊 应 ， 返 回 给 客户 
sin ES TR AS A HL 7 404 © 





我 们 注册 了 ErrorMiddleware 类 ， 它 占据 中 间 件 
管道 中 的 第 一 个 位 置 。 对 于 仅 需 要 处 理 响应 的 中 间 
件 ， 这 可 能 看 起 来 很 奇怪 ， 但 是 在 链 的 开始 位 置 注 
册 中 间 件 可 确保 能 够 处 理 任何 其 他 中 间 件 生成 的 响 
应 ， 如 图 14-11 所 示 。 如 果 放 置 在 管道 的 后 面 位 


























置 ， 那 么 只 能 处 理由 茶 些 其 他 中 间 件 生成 的 啊 应 。 


we tE 请 求 编辑 中 间 件 短路 中 间 件 








图 14-11 将 啊 应 编辑 中 间 件 添加 到 中 间 件 管道 中 


可 以 通过 启动 应 用 程序 并 请 求 除 //middleware 
UREL 外 的 任何 URL 来 查看 新 添加 的 中 间 件 的 效果 。 


结果 将 显示 图 14-12 所 示 的 错误 消息 。 





DB locathost65416/otherUn x 


€ Œ | © localhost:65416/ott wr] : 


图 14-12 ”编辑 其 他 中 间 件 时 的 啊 应 
14.4.3 ”了解 如 何 调用 Configure 方 法 


ASP.NET Core 平 台 会 在 调用 之 前 检查 


Configure 方 法 ， 并 获取 其 参数 列表 ， 该 列表 由 
ConfigureServices 方 法 中 设置 的 服务 或 表 14-5 中 显示 
的 特殊 服务 〈 可 用 作 Configure 方 法 的 参数 ) 提供 。 


表 14-5 ”特殊 服务 


特殊 服务 























IApplicationBuilder | 定义 了 设置 应 用 程序 中 间 件 管道 所 需 的 功能 











定义 了 区 分 不 同类 型 环境 (如 开发 环境 和 生产 环境 ) 所 需 的 功能 


1. 使 用 Application Builder 


虽然 不 必 为 Configure 方 法 定义 任何 参数 ， 但 大 
多 数 Startup 类 至 少 使 用 IApplicationBuilder， 因 为 它 
允许 创建 中 间 件 管道 。 对 于 上 自 定 义 中 间 件 来 说 ， 
UseMiddleware 扩 展 方法 用 于 注册 类 。 复 杂 的 内 容 
生成 中 间 件 包 提 供 了 单一 方法 以 在 一 个 步骤 中 设置 
所 有 的 中 间 件 ， 就 像 它们 提供 单一 方法 来 定义 使 用 
的 服务 一 样 。 对 于 MVC 来 说 ， 可 以 使 用 两 种 扩展 方 
法 ， 如 表 14-6 所 示 。 





表 14-6 两 种 扩展 方法 


扩展 方法 


UseMvcWithDefaultRoute | 使 用 默认 路 由 设置 MVC 中 间 件 




































































使 用 Lambda 表 达 式 指定 的 自 定义 路 由 配置 设置 MVC 中 间 件 





路 由 是 将 请 求 URL 映 射 到 控制 器 并 由 应 用 程序 


定义 操作 的 过 程 ， 第 15 草 和 第 16 章 将 详细 摘 述 路 
由 。UseMvcWithDefaultRoute 扩 展 方法 对 于 开始 使 
用 MVC 很 有 用， 但 是 大 多 数 应 用 程序 会 调用 
UseMvc 扩 展 方法 ， 即 使 结果 是 显 式 定义 了 由 
UseMvcWithDefaultRoute 扩 展 方法 创建 的 相同 的 路 
由 配置 ， 如 代码 清单 14-27 所 示 。 这 使 得 其 他 开发 

员 能 够 很 容易 理解 应 用 程序 使 用 的 路 由 配置 ， 并 
且 以 后 可 以 轻松 添加 新 的 路 由 (几乎 所 有 应 用 程序 
在 某 些 时 候 都 需要 ) 。 




















代码 清单 14-27 在 ConfiguringApps 文 件 夹 下 的 Startup.cs 文 件 
中 设置 MVC 中 间 件 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using ConfiguringApps.Infrastructure; 


namespace ConfiguringApps { 


public class Startup { 
public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<UptimeService>() ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseMiddleware<ErrorMiddleware>(); 
app.UseMiddleware<BrowserTypeMiddleware>(); 
app.UseMiddleware<ShortCircuitMiddleware>() 


app.UseMiddleware<ContentMiddleware>(); 


app.UseMvc(routes => { 
routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 


n=Index}/{id?}"); 
}); 








由 于 MVC 设 置 了 内 容 生 成 中 间 件 ， 因 此 
UseMvc 扩 展 方法 必须 在 注册 了 所 有 其 他 中 间 件 之 
后 调用 。 为 了 准备 MVC 所 依赖 的 服务 ， 必 须 在 
ConfigureServices 方 法 中 调用 AddMvc 扩 展 方法 。 





2. 使 用 托管 环境 


IHostingEnvironment 接 口 使 用 表 14-7 所 示 的 属 
性 提供 有 关 运 行 应 用 程序 的 托管 环境 的 一 些 基 本 但 
非常 重要 的 信息 。 


4214-7 IHostingEnvironment 属 性 


Be 描述 当前 环境 的 字符 串 
Ce | amma nese MRE 






















































































j TE, ARES TEE LG IA BE RAS AN AS OC EE 
WebRootPath EAN 
来 ， :wwwroot 文 件 夹 


一 个 实现 了 IFileProvider 接 口 的 对 象 ， 该 对 象 可 用 于 从 
ContentRootPath 属 性 指定 的 文件 夹 中 读 取 文 件 








ContentRootFileProvider 














返回 一 个 实现 了 IFileProvider 接 口 的 对 象 ， 该 对 象 可 用 于 从 
WebRootPath 属 性 指定 的 文件 夹 中 读 取 文件 


WebRootFileProvider 














ContentRootPath 和 WebRootPath 属 性 很 有 意 
思 ， 但 大 多 数 应 用 程序 中 并 不 需要 这 两 个 属性 ， 
为 有 一 个 内 置 的 中 间 件 可 用 于 传递 静态 内 容 。 








比较 重要 的 属性 是 EnvironmentName， 它 允许 
根据 应 用 程序 运行 的 环境 修改 应 用 程序 的 配置 。 有 
3 种 常规 环境 一 一 开发 环境 、 暂 存 坏 境 和 生产 环 


Kio 








使 用 名 为 ASPNETCORE_ENVIRONMENT 的 
环境 变量 设置 当前 托管 环境 。 要 设置 环境 变量 ， 请 
从 Visual Studio} Project $ P 4i F% 
ConfiguringApps Properties， 然 后 切换 到 Debug 选 项 
卡 。 双 击 环 境 变量 的 Value 字段 ， 默 认 情 况 下 设置 
为 Development， 将 之 更 改 为 Staging， 如 图 14-13 所 
示 。 保 存 更 改 以 使 新 环境 生效 。 











eaa i an ee mal aoe 





图 14-13 ”设置 托管 环境 的 名 称 


YY 
提示 


环境 名 称 不 区 分 大 小 写 ， 因 此 Staging 和 staging 
可 视 为 同一 环境 。 虽 然 Development、Staging 和 
Production 是 传统 的 环境 名 称 ， 但 你 可 以 使 用 目 己 
ENTE Ao. BI, MRA PASTA 
员 ， 并 且 每 个 开 及 人 员 都 需要 不 同 的 配置 设置 ， 那 
么 这 可 能 很 有 用 。 有 关 如 何 处 理 环境 配置 之 间 复 杂 











差异 的 详细 信息 ， 请 参阅 14.7 节 。 


在 Configure 方 法 中 ， 可 以 通过 读 取 
IHostingEnvironment.EnvironmentName 必 性 或 使 用 
对 IHostingEnvironment 对 象 进行 操作 的 扩展 方法 之 
一 来 确定 正在 使 用 的 托管 环境 ， 如 表 14-8 所 示 。 








414-8 IihostingEnvironment 的 扩展 方法 





扩展 方法 
IsStaging() 如 果 托 管 环境 的 名 称 是 Staging， 返 回 true 




















扩展 方法 用 于 更 改 中 间 件 管道 中 的 中 间 件 集 


























合 ， 以 定制 应 用 程序 到 不 同 托管 环境 的 行为 。 代 码 
清单 14-28 使 用 一 种 扩展 方法 来 确保 本 章 前 面 创建 
的 目 定 义 中 间 件 仅 出 现在 Development 托 管 环境 的 
管道 中 。 





代码 清单 14-28 ”在 ConfiguringApps 文 件 夹 下 的 Startup.cs 文 件 
中 使 用 托管 环境 











using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using ConfiguringApps.Infrastructure; 


namespace ConfiguringApps { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<UptimeService>() ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 


if (env.IsDevelopment()) { 
app.UseMiddleware<ErrorMiddleware>() ; 
app .UseMiddleware<BrowserTypeMiddleware 
>(); 
app.UseMiddleware<ShortCircuitMiddlewar 
e>(); 
app .UseMiddleware<ContentMiddleware>() ; 


} 


app.UseMvc(routes => { 
routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 


n=Index}/{id?}"); 
})5 





这 3 个 日 定义 中 间 件 不 会 添加 a 到 使 用 当前 配置 
的 管道 中 ， 当 前 配置 已 将 托管 环境 设置 为 Staging。 
如 果 运 行 应 用 程序 并 请 求 /middleware UREL， 你 将 收 
到 404-Not Found 错 误 ， 因 为 唯一 可 用 的 中 间 件 是 使 
用 UseMvc 扩 展 方 法 设置 的 ， 它 们 没有 可 用 于 处 理 
IZURLKI FE HIAS o 























YO 
vy =e 
e D. 


一 旦 测试 了 更 改 托管 环境 的 效果 ， 就 请 务必 更 
改 回 Development 否则 ， 本 章 其 余部 分 的 示例 将 
无 法 正常 工作 。 


14.4.4 添加 其 他 中 间 件 


有 一 组 第 用 的 中 间 件 在 大 多 数 MVC 项 目 中 很 
有 用 ， 本 书 的 示例 中 也 使 用 了 这 些 中 间 件 。 下 面 将 
这 些 中 间 件 添加 到 请 求 党 道中 并 解释 它们 的 工作 原 
HH 





1. 启用 异常 处 理 


即使 古 精 心 编写 的 应 用 程序 也 会 过 到 寞 音 ， 因 
此 适当 地 处 理 它 们 非常 重要 。 代 码 清单 14-29 添 加 
了 一 些 中 间 件 ， 用 于 处 理 请 求 管道 发 生 的 异常 。 这 


FA 





删除 了 目 定 义 中 间 件 ， 以 便 可 以 专注 于 MVC。 


代码 清单 14-29 在 ConfiguringApps 文 件 严 下 的 Startup.cs 文 件 





中 添加 异常 处 理 中 间 件 





using 
using 
using 
using 
using 
using 
using 
using 
using 


System; 

System.Collections.Generic; 

System. Ling; 

System. Threading.Tasks; 
Microsoft.AspNetCore. Builder; 
Microsoft.AspNetCore.Hosting; 
Microsoft.AspNetCore.Http; 
Microsoft.Extensions.DependencyInjection; 
ConfiguringApps. Infrastructure; 


namespace ConfiguringApps { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 


n services) { 


services.AddSingleton<UptimeService>() ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 


IHostingEnvironment env) { 


if (env.IsDevelopment()) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages() ; 

} else { 
app.UseExceptionHandler("/Home/Error" ) ; 


app.UseMvc(routes => { 
routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 


n=Index}/{id?}"); 


3 





UseStatusCodePages 77 1244 -HAIA TEYK AAS Bl) 
不 包含 内 容 的 啊 应 中 ， 例 如 404-Not Found 啊 应 ， 这 
可 能 很 有 用 ， 因 为 并 非 所 有 浏览 器 都 问 用 户 显示 自 
CAA. 








A na 设置 一 个 错误 
处 理 中 间 件 ， 这 个 中 间 件 在 啊 应 中 显示 寞 常 的 详细 
信息 ， 包 括 异 党 跟踪 。 这 些 信息 不 应 该 同 用 户 显 














示 ， 因 此 只 能 在 使 用 IHostingEnvironment 对 象 检测 
到 的 开发 托管 环境 中 调用 
UseDeveloperExceptionPage 方 法 。 


对 于 Staging 或 Production 环 境 ， 使 用 
UseExceptionHandler 方 法 。 该 方法 设置 错误 处 理 ， 
允许 显示 目 定 义 错误 消息 ， 不 会 显示 应 用 程序 的 内 
部 错误 细节 。UseExceptionHandler 方 法 的 参数 是 客 
户 端 应 重 定 同 到 的 URL， 以 便 接 收 错误 消息 。 这 可 
以 是 应 用 程序 提供 的 任何 URL， 但 惯例 是 使 
用 /Home/Error。 























在 代码 清单 14-30 中 ， 添 加 了 根据 需要 为 Home 
Pe till as HJ Index PRE aoe is Ae, FNI T 
Error 操 作 ， 以 处 理 UseExceptionHandler 生 成 的 请 








代码 清单 14-30 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 


件 中 生成 和 处 理 异 常 





using System.Collections.Generic; 
using Microsoft.AspNetCore.Mvc; 
using ConfiguringApps. Infrastructure; 


namespace ConfiguringApps.Controllers { 


public class HomeController : Controller { 
private UptimeService uptime; 


public HomeController(UptimeService up) => upti 
me = up; 


public ViewResult Index(bool throwException = f 
alse) { 
if (throwException) { 
throw new System.NullReferenceException 
()3 
} 


return View(new Dictionary<string, string> { 
["Message"] = "This is the Index action 
["Uptime"] = $"{uptime.Uptime}ms" 
}); 
} 


public ViewResult Error() => View(nameof (Index), 


new Dictionary<string, string> { 
["Message"] = "This is the Error action 


"}); 


对 Index 操 作 的 更 改 依赖 于 第 26 章 描述 的 模型 
绑 定 功能 ， 以 从 请 求 中 获取 throwException 的 值 。 
如 果 throwException 为 tue，Index 操 作 抛 出 
NullReferenceException; 如 果 为 false， 束 正常 执 


一 … 


{JT o 








Error 操 作 使 用 dex 视 图 显示 简单 消 轧 。 可 以 
通过 运行 应 用 程序 并 请 求 /Home/Index? 
throwException=true URL 来 查看 不 同 异 党 处 理 中 则 
件 的 效果 。 查 询 字 符 串 提供 了 Index 操作 参数 的 
值 ， 你 看 到 的 响应 将 取决 于 托 省 环境 的 名 称 。 图 
14-14 显 示 了 UseDeveloperExceptionPage (用 于 开发 
托管 环境 ) 和 UseExceptionHandler 中 间 件 《用 于 所 
有 其 他 托管 环境 ) 生成 的 输出 结 

















| a 
e= m 
图 14-14 ”输出 结果 
开发 人 员 异 彰 页 面 提 供 了 异 帝 的 详细 信息 ， 以 


及 合 看 堆栈 跟踪 和 导致 异 第 的 请 求 的 选项 。 相 比 之 
下 ， 用 户 寞 常 页 面 应 该 仅 用 于 表示 发 生 了 错误 。 


2. 启用 浏览 器 链接 


第 6 前 介 绍 了 浏览 器 链接 功能 ， 并 演示 了 如 何 
在 开发 过 程 中 用 来 管理 浏览 右 。 浏 览 右 链接 的 服务 
器 端 部 分 是 作为 中 间 件 实现 的 ， 必 须 作 为 应 用 程序 
配置 的 一 部 分 添加 到 Startup 类 中 ; AI, Visual 
Studio 集 成 将 无 法 工作 。 浏 览 器 链接 仅 在 开发 期 间 
有 用 ， 不 应 在 暂 存 环境 或 生产 环境 中 使 用 ， 因 为 还 
会 编辑 其 他 中 间 件 生成 的 啊 应 ， 并 插入 JavaScript 代 











码 。 打 开 到 服务 器 端的 HTTP 连接 ， 以 接收 重新 加 
载 的 通知 。 在 代码 清单 14-31 中 ， 可 以 看 到 如 何 仅 
为 开发 托管 环境 调用 已 注册 中 间 件 的 
UseBrowserLink 方 法 。 


代码 清单 14-31 ”在 ConfiguringApps 文 件 夹 下 的 Startup.cs 文 件 
中 局 用 浏览 如 链接 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using ConfiguringApps.Infrastructure; 


namespace ConfiguringApps { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services .AddSingleton<UptimeService>() ; 
services.AddMvc(); 


public void Configure(IApplicationBuilder app, 
THostingEnvironment env) { 


if (env.IsDevelopment()) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages() ; 
app.UseBrowserLink() ; 

} else { 
app.UseExceptionHandler("/Home/Error" ) ; 


app.UseMvc(routes => { 
routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 


n=Index}/{id?}"); 


3 





3. 启用 静态 内 容 





最 后 一 个 中 间 件 对 大 多 数 项 目 很 有 用 ， 它 提供 
了 对 wwwroot 文 件 夹 中 文件 的 访问 ， 使 应 用 程序 可 
以 包含 图 像 、JavaScript 文 件 和 CSS。 使 用 
UseStaticFiles 方 法 琴 加 一 个 组 件 ， 用 于 将 静态 文件 
的 请 求 管道 短路 ， 如 代码 清单 14-32 所 示 。 





代码 清单 14-32 在 ConfiguringApps 文 件 严 下 的 Startup.cs 文 件 


中 局 用 静态 内 容 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using ConfiguringApps.Infrastructure; 


namespace ConfiguringApps { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<UptimeService>() ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 


if (env.IsDevelopment()) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages() ; 
app.UseBrowserLink() ; 

} else { 
app.UseExceptionHandler("/Home/Error" ) ; 

} 

app.UseStaticFiles(); 

app.UseMvc(routes => { 
routes .MapRoute( 


name: "default", 
template: "{controller=Home}/{actio 


n=Index}/{id?}"); 
}); 





KAFEA, WAR TAPAS A, X 
就 是 为 所 有 环境 调用 UseStaticFiles 方 法 的 原因 。 这 
意味 着 Index 视 图 中 的 link 元 素 将 正常 工作 ， 并 允许 
M ba. as JX Bootstrap CSS 样 式 表 。 可 以 通过 启动 应 
用 程序 来 但 看 效果 ， 如 图 14-15 所 示 。 








图 14-15 ”启用 静态 内 容 


14.5 配置 应 用 程序 


东 些 配置 数据 经 闻 更 改 ， 例 如 ， 当 应 用 程序 从 


开发 环境 转移 到 生产 环境 时 ， 数 据 库 服务 才 需 要 不 
同 的 信息 。ASP.NET Core 并 不 在 Startup 类 中 对 此 信 
居 进 行 便 编 码 ， 而 是 从 一 系列 更 容易 更 改 的 源 端 提 
供 配 置 数 据 ， 例 如 环境 变量 、 命 令 行 参 数 以 及 使 用 
JavaScript Object Notation (JSON) 编写 的 文件 。 

















配置 数据 通常 是 自动 处 理 的 ， 但 由 于 已 经 营 换 
了 Program 类 中 的 默认 设置 ， 因 此 需要 显 式 添加 获 
取 数 据 的 代码 ， 并 使 其 可 用 于 应 用 程序 的 其 他 部 
分 ， 如 代码 清单 14-33 所 示 。 











代码 清单 14-33 在 ConfiguringApps 文 件 严 下 的 Program.cs 文 件 
中 加 载 配置 数据 





using System; 

using System.Collections.Generic; 

using System. IO; 

using System. Linq; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.Configuration; 
using Microsoft.Extensions.Logging; 

using System.Reflection; 


namespace ConfiguringApps { 
public class Program { 


public static void Main(string[] args) { 
BuildWebHost(args).Run(); 


} 
public static IWebHost BuildWebHost(string[] ar 
gs) { 
return new WebHostBuilder() 
.UseKestrel() 
.UseContentRoot (Directory.GetCurrentDir 
ectory()) 


. ConfigureAppConfiguration( (hostingCont 
ext, config) => { 
config.AddJsonFile("appsettings.jso 


optional: true, reloadOnChange: 


config.AddEnvironmentVariables() ; 
if (args != null) { 
config .AddCommandLine(args) ; 


} 


}) 
.UseIISIntegration() 


.UseStartup<Startup>() 
.Build(); 





ConfigureAppConfiguration 方 法 用 于 处 理 配置 


数据 ， 其 参数 是 WebHostBuilderContext 对 象 和 实现 
了 IConfigurationBuilder 接 口 的 对 象 。 


WebBostBuilderContext 类 定义 了 表 14-9 中 摘 述 的 属 
性 。 


表 14-9 ”由 WebBostBuilderContext 关 定义 的 属性 






































返回 一 个 实现 了 IHostingEnvironment 接 口 的 对 象 ， 并 提供 有 关 运 行 
用 程序 的 托管 环境 的 信息 。 有 关 详 细 信 息 


Ay 


HostingEnvironment 
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配置 数据 的 只 读 访问 






































Configuration 
































IConfigurationBuilder 接 口 用 于 为 应 用 程序 的 其 
余部 分 准备 配置 数据 ， 这 通 第 使 用 扩展 方法 完成 。 
表 14-10 描 述 了 代码 清单 14-33 中 用 于 添加 配置 数据 
的 3 个 扩展 方法 。 








表 14-10 ”用 于 添加 配置 数据 的 扩展 方法 


| 








扩展 方法 描述 





























用 于 从 JSON 文 件 〈 例 如 appsettings.json) 加 载 配置 数据 











AddEnvironmentVariables 明 于 从 环境 变量 加 载 配置 数据 






































AddCommandLine 有 于 从 启动 应 用 程序 的 命令 行 参 数 加 载 配 置 数 据 




















在 代码 清单 14-33 所 示 的 用 于 加 载 配置 数据 的 3 
个 方法 中 ， 最 有 趣 的 是 AddJjsonFile 方 法 。 该 方法 的 
参数 指定 了 文件 名 、 文 件 是 否 可 选 以 及 在 文件 更 改 
时 和 是否 应 重新 加 载 配 置 效 扼 : 





config.AddJsonFile("appsettings.json", optional: true, 


reloadOnChange: true); 





以 上 代码 指定 了 一 个 名 为 appsettings.json 的 文 
件 ， 这 是 JSON 配 置 文件 的 常规 名 称 。 
appsettings.json 文 件 是 可 选 的 ， 也 就 是 说 ， 如 采 文 
件 不 存在 ， 不 会 引 及 异 冲 ， 并 且 将 监视 更 改 和 目 动 


刷新 配置 数据 。 


重新 加 载 配置 数据 


ASP.NET Core 配 置 系统 文 持 在 配置 文件 更 改 时 
重新 加 载 数 据 。 某 些 内 置 中 间 件 (如 日 志 记 录 系 
统 ) 文 持 此 功能 ， 这 意味 着 可 以 在 运行 时 更 改 日 志 
记录 级 别 ， 而 无 须 重 新 启动 应 用 程序 。 你 也 可 以 在 
自 定 义 中 间 件 中 包含 类 似 功能 。 








但 仅仅 因为 文 持 这 个 功能 而 使 用 它 并 不 意味 看 
就 是 切合 实际 的 。 在 生产 系统 中 更 改 配置 文件 是 导 
致 停机 的 原因 之 一 ， 很 容易 产生 输入 错误 并 导致 创 
建 错误 的 配置 。 即 使 成 功 进 行 了 更 改 ， 也 可 能 出 现 
无 法 预料 的 后 果 ， 例 如 日 志 数 据 填 满 磁盘 或 导致 性 


能 下 降 。 





建议 避免 实时 编辑 ， 并 确保 在 部 署 到 生产 环境 
之 前 将 所 有 更 改 推送 到 标准 测试 流程 中 。 针 对 实时 
运行 的 系统 来 诊断 问题 可 能 很 容易 ， 但 结果 可 能 并 
不 会 尽 如 人 意 。 如 采 你 正在 编辑 生产 环境 中 的 配置 
文件 ， 那 么 应 该 愤 重 考虑 是 否 要 将 一 个 小 问题 变 成 
一 个 更 大 的 问题 。 

















14.5.1 创建 JSON 配 置 文件 


appsettings.json 文 件 的 最 第 见 用 途 是 存储 数据 
库 连 接 字 符 串 和 日 志 记 录 设 置 ， 但 也 可 以 存储 应 用 
程序 所 需 的 任何 数据 。 


要 查看 配置 系统 的 工作 方式 ， 请 将 名 为 
appsettings.json 的 新 JSON 文 件 添 加 到 项 目的 根 文件 
夹 中 ， 内 容 如 代码 清单 14-34 所 示 。 


代码 清单 14-34 ”ConfiguringApps 文 件 夹 下 的 appsettings.json 文 
件 的 内 容 


"ShortCircuitMiddleware": { 
"EnableBrowserShortCircuit": true 


lL 





} 





可 以 为 JSON 格 式 定 义 配 置 的 结构 。 以 上 代码 
中 的 JSON 内 容 定 义 了 名 为 ShortCircuitMiddleware 的 
配置 类 别 ， 其 中 包含 名 为 EnableBrowserShortCircuit 
的 配置 属性 ， 它 被 设置 为 true。 


JSON 中 的 引号 和 逗号 


如 有 果 不 熟 悉 JSON， 那 么 值得 花 一 些 时 间 阅 读 
JSON 网 站 上 的 规范 。JSON 格 式 易于 使 用 ， 并 且 大 
多 数 平台 对 生成 和 解析 JSON 数 据 提供 了 良好 支 
持 ， 包 括 MVC 应 用 程序 和 使 用 简单 Javascript API 的 





客户 端 。 事 实 上 ， 大 多 数 MVC 开 发 人 员 根 本 不 会 直 
接 与 JSON 打 交道 ， 只 有 在 配置 文件 中 才 需 要 手动 
编码 JSON。 





关于 JSON 有 两 个 很 多 开发 人 员 容 易 遇 到 的 陷 
阱 ， 虽 然 仍然 需要 人 花 时 间 阅 读 规范 ， 但 是 当 Visual 
Studio 或 ASP.NET Core 无 法 解析 JSON 文 件 的 时 候 ， 
了 解 最 常见 的 问题 会 让 你 更 容易 找到 原因 。 下 面 是 
对 appsettings.json 文 件 的 补 序 ， 显 示 了 两 个 最 第 见 


的 问题 : 








"ShortCircuitMiddleware": { 
"EnableBrowserShortCircuit": true 


} 
mysetting : [ fast, slow ] 





首先 ，JSON 的 几乎 所 有 扩容 都 是 用 引号 括 起 
来 的 。 如 果 正 在 编写 C# 代 码 并 期 望 在 没有 引 和 号 的 情 
况 下 接收 属性 的 名 称 和 值 ， 吏 会 很 容易 还 记 这 一 








扩 。 在 JSON 中 ， 所 有 除 布 尔 值 和 数字 之 外 的 其 他 
JADAR 引号 括 起 来 ， 如 下 所 示 : 


"ShortCircuitMiddleware": { 
"EnableBrowserShortCircuit": true 


} 
"mysetting”: [ "fast", "slow"] 





} 


其 次 ， 在 向 对 象 的 JSON 描 述 添 加 一 个 新 的 属 
性 时 ， 必 须 记 住 在 上 一 个 大 括号 字符 的 后 面 添 加 一 
个 逗号 ， 如 下 所 示 : 


{ 
"ShortCircuitMiddleware": { 


"EnableBrowserShortCircuit": true 


}; 
"mysetting" : [ "fast", "slow" ] 





} 





即使 这 个 错误 已 高 有 党 显示 也 很 难看 出 差异 一 一 
这 了 融 是 为 什么 这 类 错误 如 此 第 见 但 这 里 已 经 在 
关闭 ShortCircuitMiddleware 部 分 的 个 ”后 添加 了 一 个 











加 号 。 男 外 要 小 心 ， 引 号 后 没有 其 他 节点 也 是 非法 
的 。 如 果 因 为 更 改 JSON 导 致 问题 发 生 ， 那 么 首先 


要 检查 这 两 个 错误 。 


14.5.2 ”使 用 配置 数据 


Startup 类 可 以 通过 使 用 IConfiguration 参 数 定 义 
的 构造 函数 来 访问 配置 数据 。 在 Program 类 中 调用 
UseStartup 方 法 时 ， 会 使 用 
ConfigureAppConfiguration 准 备 的 配置 数据 创建 
Startup 对 象 。 代 码 清 单 14-35 疝 Startup 类 添加 了 构造 
为 数 ， 并 显示 了 如 何 访问 配置 数据 。 


代码 清单 14-35 ”在 ConfiguringApps 文 件 夹 下 的 Startup.cs 文 件 
中 接收 和 使 用 配置 数据 





using System; 
using System.Collections.Generic; 


using System.Ling; 


using System.Threading.TasKs ; 

using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using ConfiguringApps.Infrastructure; 

using Microsoft.Extensions.Configuration; 


namespace ConfiguringApps { 
public class Startup { 


public Startup(IConfiguration configuration) { 
Configuration = configuration; 


} 


public IConfiguration Configuration { get; } 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<UptimeService>(); 
services.AddMvc(); 
} 
public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 


if ((Configuration.GetSection("ShortCircuit 

Middleware")? 

.GetValue<bool>("EnableBrowserShort 
Circuit")).Value) { 

app.UseMiddleware<BrowserTypeMiddle 
ware>(); 

app .UseMiddleware<ShortCircuitMiddl 
eware>(); 


} 


if (env.IsDevelopment()) { 


app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages(); 
app.UseBrowserLink() ; 

} else { 
app.UseExceptionHandler("/Home/Error" ) ; 


app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 


n=Index}/{id?}"); 
})5 





构造 函数 接收 IConfiguration 对 象 并 将 其 分 配给 
名 为 Configuration 的 属性 ， 然 后 可 以 使 用 该 属性 访 
问 配 置 数据 ， 这 些 配置 数据 已 从 环境 变量 、 命 令 行 
和 appsettings.json 文 件 加 载 。 








要 获取 值 ， 可 以 将 数据 结构 导航 到 所 需 的 配置 
部 分 ， 这 部 分 由 实现 了 IConfiguration 接 口 的 另 一 个 
对 象 表示 ， 访 接口 提供 了 可 用 于 IConfigurationRoot 
的 成 员 ， 如 表 14-11 所 示 。 


表 14-11 可 用 于 IConfigurationRoot 的 成 员 


























于 获取 特定 键 的 字符 串 人 




















一 个 IConfiguration 对 象 ， 该 对 象 表示 配置 数据 的 一 个 节点 

















IConfiguration 对 象 的 子 节点 条 目 ， 用 来 表示 当前 配置 对 象 的 








还 有 一 些 扩展 方法 可 用 于 对 IConfiguration 对 象 
进行 操作 以 获取 值 并 将 其 从 字符 串 转 换 为 其 他 类 
型 ， 如 表 14-12 所 示 。 





表 14-12 IConfiguration 接 口 的 扩展 方法 


获取 与 指定 键 关 联 的 值 ， 并 尝试 将 其 转换 为 类 型 T 
































GetValue<T> 获取 与 指定 键 关 联 的 值 ， 并 尝试 将 其 转换 为 类 型 IT。 如果 配 置 数 
































(keyName,defaultValue) | 据 中 的 键 没 有 值 ， 就 使 用 默认 值 




















重要 的 是 ， 不 要 假设 配置 值 一 定 会 被 指定 。 可 
使 用 null 条 件 运 算 符 来 确保 在 尝试 获取 
EnableBrowser- ShortCircuit 值 之 前 已 获取 到 
ShortCircuitMiddleware 部 分 。 结 果 是 ， 只 有 在 定义 
了 ShortCircuitMiddleware/ 
EnableBrowserShortCircuit 值 并 将 其 设置 为 true 时 ， 
才 会 将 目 定义 中 间 件 添加 到 请 求 管道 中 。 








1453 ”配置 日 志 记 录 


ASP.NET Core 提 供 对 捕获 和 处 理 日 志 记 录 数 据 
sed FHA CAN BS Pla A iwr 

。 大 多 数 项 目 会 自动 设置 日 志 记 录 ， 但 由 于 在 
Program 类 中 使 用 了 单独 的 配置 语句 ， 因 此 需要 添 
加 代码 清单 14-36 所 示 的 语句 来 设置 日 志 记 录 功 


能 。 








代码 清单 14-36 在 ConfiguringApps 文 件 夹 下 配置 Program.cs 文 


件 中 的 日 志 记录 





using System; 

using System.Collections.Generic; 

using System. IO; 

using System. Linq; 

using System. Threading.Tasks; 

using Microsoft.AspNetCore; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.Configuration; 
using Microsoft.Extensions.Logging; 

using System.Reflection; 


namespace ConfiguringApps { 
public class Program { 


public static void Main(string[] args) { 
BuildWebHost(args).Run(); 


} 
public static IWebHost BuildWebHost(string[] ar 
gs) { 
return new WebHostBuilder() 
.UseKestrel() 
.UseContentRoot (Directory.GetCurrentDir 
ectory()) 


.ConfigureAppConfiguration( (hostingCont 
ext, config) => { 
config.AddJsonFile("appsettings.jso 


optional: true, reloadOnChange: 


config.AddEnvironmentVariables(); 


if (args != null) { 
config.AddCommandLine(args) ; 
} 
}) 
.ConfigureLogging((hostingContext, logg 
ing) => { 
logging. AddConfiguration( 
hostingContext.Configuration.Ge 
tSection("Logging")); 
logging.AddConsole(); 
logging .AddDebug() ; 


}) 
.UseIISIntegration() 
.UseStartup<Startup>() 
.Build(); 





ConfigureLogging 方 法 使 用 Lambda 函 数 设置 日 
志 记 录 系 统 ，Lambda 函 数 接收 
WebHostBuilderContext 对 象 〈 可 参考 本 章 前 面 的 内 
Z) 和 实现 了 ILoggingBuilder 接 口 的 对 象 。 
ILoggingBuilder 接 口 运行 一 组 扩展 方法 来 配置 日 志 
记录 系统 ， 如 表 14-13 所 示 。 








表 14-13 ”ILoggingBuilder 接 口 的 扩展 方法 





扩展 方法 描述 























”| 用 于 使 用 从 appsettingsjson 文 件 、 命 令 行 或 环境 变量 加 载 的 配置 数据 来 
AddConfiguration 
配置 日 志 记 录 系 统 
































将 日 志 消息 发 送 到 控制 台 ， 这 在 使 用 dotnet run 命 令 局 动 应 用 程序 时 非常 





























当 Visual Studio 调 试 器 运行 时 ， 将 日 志 消 息 发 送 到 调试 输出 窗口 


























将 日 志 消 息 发 送 到 Windows 事 件 日 志 ， 如 果 已 部 署 到 Windows Server, 
AddEventLog ”| 并 希望 将 来 自 ASP.NET Core MVC 应 用 程序 的 日 志 消息 与 其 他 类 型 的 应 
用 程序 中 的 日 志 消息 合并 ， 这 将 非常 有 用 




































































1. 了解 日 志 记 录 配 置 数据 


AddConfiguration 方 法 用 于 使 用 配置 数据 来 配 
置 日 志 记 录 系 统 ， 通 名 在 appsettings.json 文 件 中 定 
义 。 人 代码 清 单 14-37 将 名 为 Logging 的 配置 部 分 添加 
到 appsettings.json 文 件 中 ， 这 部 分 配置 对 应 于 代码 
清单 14-36 中 用 于 AddConfiguration 方 法 的 名 称 。 


代码 清单 14-37 ”将 配置 部 分 添加 到 ConfiguringApps 文 件 夹 下 


的 appsettings.json 文 件 中 


"ShortCircuitMiddleware": { 
"EnableBrowserShortCircuit": true 
Jo 
"Logging": { 
"LogLevel": { 


"Default": "Debug", 
"System": "Information", 
"Microsoft": "Information" 











Logging 配 置 部 分 指定 应 从 不 同 的 日 六 记录 数 
据 源 显示 的 消息 级 别 。 日 志 记 录 系 统 支持 7 个 级 别 
的 调试 信息 ， 表 14-14 按 重要 性 对 它们 进行 了 排 
列 。 


表 14-14 调试 级 别 



























































F 发 期 间 有 用 但 在 生产 环境 中 不 需要 的 消息 


调试 级 别 




















Debug j 于 开发 人 员 因 调试 问题 所 需 的 详细 消息 
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| i | | aig : 
日 于 禁用 日 志 记 录 消 息 


代码 清单 14-37 中 的 Default 条 目 设 置 了 将 日 志 
消息 显示 到 Debug 级 别 的 国 值 ， 也 融 是 说 ， 只 显示 
Debug Al CE ZA ANIA. ERK HKA mM 
RE KE MA TAWKA AN BRUCE, MENE 
Information 级 别 或 更 高 级 别 时 才 显 示 源 日 System 或 
Microsoft 命 名 空间 的 日 记 记 录 消 晨 。 要 查看 启用 日 
忘记 录 的 效果 ， 请 通过 选择 Debug = Start 
Debugging， 使 用 Visual Studio 调 试 器 启动 应 用 程 
序 。 答 看 Output 窗 口 ， 你 将 看 到 日 志 消 息 显 示 了 如 
何 处 理 每 个 HTTP 请 求 ， 如 下 所 示 : 












































info: Microsoft.AspNetCore.Hosting.Internal.WebHost[1 ] 

Request starting HTTP/1.1 GET http://localhost:65 
417/ 
info: Microsoft.AspNetCore.Mvc.Internal.ControllerActio 
nIinvoker[1] 

Executing action method ConfiguringApps.Controlle 
rs.HomeController. Index 

(ConfiguringApps) with arguments (False) - Models 
tate is Valid 
info: Microsoft.AspNetCore.Mvc.ViewFeatures.Internal.Vi 
ewResultExecutor[1] 

Executing ViewResult, running view at path /Views 
/Home/Index.cshtml. 
info: Microsoft.AspNetCore.Mvc.Internal.ControllerActio 
nInvoker[ 2 ] 

Executed action ConfiguringApps.Controllers.HomeC 
ontroller. Index 

(ConfiguringApps) in 1597.3535ms 
info: Microsoft.AspNetCore.Hosting. Internal.WebHost[ 2 ] 

Request finished in 1695.6314ms 200 text/html; ch 
arset=utFf-8 





2. AE Be CA RS 








H 75 AS ze HH Ah dM] NZ FY 
ASP.NET Core 和 MYVC 组 件 生 成 的 。 这 种 消 妃 可 以 
ee 的 信息 ， 但 也 可 以 生成 针对 应 用 程序 自 定 

日 志 消 息 ， 如 代码 清单 14-38 所 示 。 














代码 清单 14-38 ”Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 的 自 定义 日 志 消 忆 








using System.Collections.Generic; 
using Microsoft.AspNetCore.Mvc; 

using ConfiguringApps.Infrastructure; 
using Microsoft.Extensions.Logging; 


namespace ConfiguringApps.Controllers { 


public class HomeController : Controller { 
private UptimeService uptime; 
private ILogger<HomeController> logger; 


public HomeController(UptimeService up, ILogger 
<HomeController> log) { 
uptime = up; 
logger = log; 
} 


public ViewResult Index(bool throwException = f 
alse) { 
logger.LogDebug($"Handled {Request.Path} at 
uptime {uptime.Uptime}") ; 


if (throwException) { 
throw new System.NullReferenceException 


(); 
} 


return View(new Dictionary<string, string> 
["Message"] = "This is the Index action 


["Uptime"] = $"{uptime.Uptime}ms" 


})s 
} 


public ViewResult Error() => View(nameof (Index) 


new Dictionary<string, string> { 
["Message"]|] = "This is the Error action 





ILogger 接 口 定义 了 创建 日 志 条 有 目 和 获取 实现 该 
接口 的 对 象 所 需 的 功能 ，HomeController 类 具有 类 
型 为 ILogger 的 构造 疯 数 参数 <HomeController>。 类 
型 参数 允许 日 志 记 录 系 统 在 日 志 消 奶 中 使 用 类 的 名 
称 ， 构 造 函 数 的 参数 值 是 通过 依赖 注入 功能 自动 提 
供 的 ， 可 参考 第 18 章 中 的 描述 。 








拥有 ILogger 后 ， 可 以 使 用 
Microsoft.Extensions.Logging 命 名 空间 中 定义 的 扩展 
方法 创建 日 志 消息 。 表 14-14 描 述 了 每 种 日 志 记 录 
级 别 的 方法 。HomeController 类 使 用 LogDebug 方 法 
fEDebug A HN A. BAA BOR, va AA Visual 








Studio 调 试 袁 运行 应 用 程序 ， 并 检 奉 日 志 消 息 的 
Output 窗 口 ， 其 中 的 内 容 如 下 所 示 : 


dbug: ConfiguringApps.Controllers.HomeController[6j 
Handled / at uptime 12 


局 动 应 用 程序 时 会 显示 很 多 消息 ， 很 难 挑 选 有 
用 的 消息 。 如 果 单 击 Output 窗 口 顶 部 的 Clear All 按 
tH, ZAR EI bias, MBA DA Sl RA A 
一 一 这 将 确保 仅 显 示 与 单个 请 求 相 关 的 日 志 消 息 。 




















14.5.4 配置 依赖 注入 


ASP.NET Core 应 用 程序 的 默认 配置 包括 准备 服 
务 提供 程序 ， 第 18 章 将 详细 介绍 依赖 项 注入 功能 。 
代码 清单 14-39 癌 Program 关 添加 了 配置 语句 。 


代码 清单 14-39 在 ConfiguringApps 文 件 夹 下 的 Program.cs 文 件 
中 配置 服务 


using System; 


using System.Collections.Generic; 

using System. IO; 

using System. Linq; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.Configuration; 
using Microsoft.Extensions. Logging; 

using System.Reflection; 


namespace ConfiguringApps { 
public class Program { 


public static void Main(string[] args) { 
BuildWebHost(args).Run(); 


} 
public static IWebHost BuildWebHost(string[] ar 
gs) { 
return new WebHostBuilder() 
.UseKestrel() 
.UseContentRoot (Directory.GetCurrentDir 
ectory()) 


.ConfigureAppConfiguration( (hostingCont 
ext, config) => { 
config.AddJsonFile("appsettings.jso 


optional: true, reloadOnChange: 


config.AddEnvironmentVariables() ; 
if (args != null) { 

config.AddCommandLine(args) ; 
} 


}) 
.ConfigureLogging((hostingContext, logg 


ing) => { 
logging. AddConfiguration( 
hostingContext.Configuration.Ge 
tSection("Logging") ); 
logging.AddConsole() ; 
logging. AddDebug() ; 
}) 
.UseIISIntegration() 
.UseDefaultServiceProvider((context, op 
tions) => { 
options.ValidateScopes = 
context .HostingEnvironment.IsDe 


velopment (); 


}) 
.UseStartup<Startup>() 


.Build(); 





UseDefaultServiceProvider 方 法 使 用 内 置 的 
ASP.NET Core 服 务 提供 程序 。 还 有 一 些 其 他 可 用 的 
服务 提供 程序 ， 但 大 多 数 项 目 可 以 使 用 内 置 功 能 ， 
建议 只 有 在 遇 到 需要 解决 的 特定 问题 时 才 使 用 第 三 
方 组 件 ， 并 且 需 要 对 依赖 注入 有 很 好 的 理解 ， 可 参 
考 第 18 草 中 的 描述 。 





UseDefaultServiceProvider 接 收 一 个 Lambda 孙 
数 ， 这 个 Lambda 函 数 接收 WebHostBuilderContext 对 
象 和 ServiceProviderOptions 对 象 ， 用 来 配置 内 置 的 
服务 提供 程序 。 唯 一 的 配置 属性 名 为 
ValidateScopes， 在 使 用 Entity Framework Core 时 需 
要 茶 用 ， 如 第 8 章 所 述 。 


14.6 ”配置 MVC 服 务 


在 Startup 类 的 ConfigureServices 方 法 中 调用 
AddMvc 扩 展 方法 时 ， 会 设置 MVC 应 用 程序 所 逢 的 
所 有 服务 。 这 种 方式 非常 方便 ， 因 为 可 以 在 一 个 步 
又 中 注册 所 有 MVC 服 务 ， 但 如 宁 要 改变 默认 的 行 
为 ， 那 么 确实 需要 做 一 些 额外 的 工作 来 重新 配置 服 


务 。 








AddMvc 扩 展 方法 返回 一 个 实现 了 IMvcBuilder 
接口 的 对 象 ，MVC 提 供 了 一 组 可 用 于 高 级 配置 的 扩 


展 方法 ， 其 中 一 些 有 用 的 扩展 方法 参见 表 14-15。 
另外 ， 许 多 配置 选项 与 后 面 章节 中 详细 描述 的 功能 


AR: 





AddViewOptions 





表 14-15 有 用 的 扩展 方法 










































































于 配置 允许 客户 





































































































于 配置 MVC 处 到 


于 配置 MVC 使 用 的 服务 





端 指定 接收 的 数据 格式 的 功能 


于 配置 JSON 数 据 的 创建 方式 





于 配置 Razor 视 图 引擎 


视图 的 方式 ， 包 括 使 












































j 哪 些 视图 引擎 


AddMvcOptions 坟 展 方法 用 于 配置 最 重要 的 


MVC 服 务 ， 


它 接收 一 个 函数 用 以 接收 MvcOptions 对 


象 ， 该 对 象 提供 了 一 组 配置 属性 ， 其 中 一 些 重要 属 
性 如 表 14-16 所 示 。 


4214-16 MvcOptions 对 象 的 一 些 重要 属性 











返回 模型 约定 的 列表 ， 这 些 约定 用 于 自 定义 MVC 如 何 创 建 控 
Conventions 

制 器 和 操作 
返回 一 个 映射 ， 以 允许 客户 端 指 定 接收 的 数据 格式 
于 解析 请 求 数据 的 对 象 列 表 























用 了 和 
返回 类 的 列表 ， 用 于 格式 化 从 API 控 制 器 发 送 的 数据 
指定 在 决定 用 于 响应 的 数据 格式 时 是 否 考虑 Accept 标 头 


这 些 配 置 属性 用 于 微调 MVC 的 运行 方式 ， 可 



































以 在 指定 的 章节 中 找到 与 它们 相关 的 功能 的 详细 说 
明 。 但 是 ， 作 为 快速 溃 示 ， 代 人 码 清单 14-40 显 示 了 
如 何 使 用 AddMvcOptions 方 法 更 改 配置 选项 。 


代码 清单 14-40 在 ConfiguringApps 文 件 夹 下 更 改 Startup.cs 文 
件 中 的 配置 选项 


public void ConfigureServices(IServiceCollection servic 


es) { 


services .AddSingleton<UptimeService>() ; 


services.AddMvc().AddMvcOptions(options => { 
options.RespectBrowserAcceptHeader = true; 


}); 





传递 给 AddMvcOptions 方 法 的 Lambda 表 达 式 接 
收 一 个 MvcOptions 对 象 ， 用 它 将 
RespectBrowserAcceptHeader 属 性 设置 为 tue。 这 使 
客户 问 对 内 容 协 商 过 程 中 选择 的 数据 格式 有 了 更 强 
的 控制 ， 如 第 20 章 所 述 。 


14.7 处 理 复 杂 配 置 


如 采 需 要 文 持 大 量 的 托管 环境 ， 或 者 托管 环境 
之 间 存 在 很 多 下 异 ， 那 么 在 Startup 类 中 使 用 语句 





进行 分 文 配置 可 能 会 导致 配置 难以 阅读 且 难 以 编 
辑 ， 从 而 容易 产生 意外 的 变更 。 下 面 将 介绍 使 用 
Startup 类 处 理 复杂 配置 的 不 同方 法 。 


14.7.1 创建 不 同 的 外 部 配置 文件 


Program 类 执行 的 应 用 程序 的 默认 配置 会 得 找 
特定 于 运行 应 用 程序 的 托管 环境 的 JSON 配 置 文 
件 ， 因 此 可 以 使 用 名 为 appsettings.production.json 的 
文件 来 存储 特定 于 生产 环境 的 配置 。 代 码 清单 14- 
41 恢 复 了 将 JSON 文 件 加 载 到 Program 类 的 语句 。 





代码 清单 14-41 在 ConfiguringApps 文 件 夹 下 的 Program.cs 文 件 
中 加 载 托管 环 境 文件 








using System; 

using System.Collections.Generic; 

using System. IO; 

using System. Linq; 

using System. Threading.Tasks; 

using Microsoft.AspNetCore; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.Configuration; 


using Microsoft.Extensions. Logging; 
using System.Reflection; 


namespace ConfiguringApps { 
public class Program { 


public static void Main(string[] args) { 
BuildWebHost(args).Run(); 


} 
public static IWebHost BuildWebHost(string[] ar 
gs) { 
return new WebHostBuilder() 
.UseKestrel() 
.UseContentRoot (Directory.GetCurrentDir 
ectory()) 


.ConfigureAppConfiguration( (hostingCont 
ext, config) => { 
var env = hostingContext.HostingEnv 


ironment; 
config.AddJsonFile("appsettings.jso 
n", 
optional: true, reloadOnCha 
nge: true) 


.AddJsonFile($"appsettings. {env 
.EnvironmentName}.json", 
optional: true, reloadOnCha 
nge: true); 
config.AddEnvironmentVariables(); 
if (args != null) { 
config.AddCommandLine(args) ; 
} 
}) 
.ConfigureLogging((hostingContext, logg 
ing) => { 
logging.AddConfiguration( 


hostingContext.Configuration.Ge 
tSection("Logging") ); 
logging.AddConsole() ; 
logging. AddDebug() ; 
}) 
.UseIISIntegration() 
.UseDefaultServiceProvider((context, op 
tions) => { 
options.ValidateScopes = 
context.HostingEnvironment.IsDe 
velopment(); 


}) 
.UseStartup<Startup>() 
.Build(); 





从 特定 于 平台 的 文件 加 载 配 置 数据 时 ， 里 面包 
含 的 配置 设置 将 镍 着 具有 相同 名 称 的 任何 现 有 数 
据 。 例 如 ， 使 用 ASP.NET Configuration File 模 板 创 
事 一 个 名 为 appsettings.development.json 的 文件 ， 其 
中 的 配置 数据 如 代码 清单 14-42 所 示 。 使 用 这 个 文 
件 中 的 配置 数据 将 EnableBrowserShortCircuit 设 置 为 


false。 














cr 


提 ZN 


appsettings.development.json 文 件 在 创建 后 ， 好 
像 会 消失 。 在 解决 方案 资源 管理 器 中 ， 如 果 在 
appsettings.json 条 目的 左 侧 将 鼻头 展开 ， 你 将 看 到 
Visual Studio 对 具有 相似 名 称 的 项 目 进行 了 分 组 。 


代码 清单 14-42 ”ConfiguringApps 文 件 夹 下 的 
appsettings.development.json 文 件 的 内 容 


"ShortCircuitMiddleware": { 
"EnableBrowserShortCircuit": false 


) 


} 





appsettings.json 文 件 将 在 应 用 程序 局 动 时 加 
载 ， 如 果 应 用 程序 在 开发 环境 中 运行 ， 那 么 接着 会 
加 载 appsettings.development.json 文 件 。 结 果 是 ， 当 
应 用 程序 在 开发 环境 中 运行 时 ， 
EnableBrowserShortCircuit 将 为 false， 在 和 暂 存 环境 和 
生产 环境 中 为 true。 


14.7.2 ”创建 不 同 的 配置 方法 


选择 不 同 的 配置 数据 文件 可 能 很 有 用 ， 但 无 法 
为 复 林 配置 提供 完整 的 解决 方 采 ， 因 为 数据 文件 不 
包含 C#i 语 句 。 如 果 要 更 改 用 于 创建 服务 或 注册 中 间 
件 的 配置 语句 ， 则 可 以 使 用 不 同 的 方法 ， 其 中 方法 
的 名 称 包 括 托 各 环境 ， 如 代码 清单 14-43 所 示 。 











代码 清单 14-43 ”在 Startup.cs 文 件 中 使 用 不 同 的 方法 名 称 





using System; 

using System.Collections.Generic; 
using System.Ling; 

using System. Threading. Tasks; 


using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using ConfiguringApps.Infrastructure; 

using Microsoft.Extensions.Configuration; 


namespace ConfiguringApps { 
public class Startup { 


public Startup(IConfiguration configuration) { 
Configuration = configuration; 


} 


public IConfiguration Configuration { get; } 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<UptimeService>(); 
services.AddMvc().AddMvcOptions(options => 


options.RespectBrowserAcceptHeader = tr 
ue; 
})3 
} 


public void ConfigureDevelopmentServices(IServi 
ceCollection services) { 
services.AddSingleton<UptimeService>() ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseExceptionHandler("/Home/Error"); 
app.UseStaticFiles(); 


app.UseMvc(routes => { 
routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 
n=Index}/{id?}"); 
}); 
} 


public void ConfigureDevelopment(IApplicationBu 
ilder app， 


IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages() ; 
app.UseBrowserLink(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 





“4 ASP.NET Core 在 Startup 类 中 查找 
ConfigureServices 和 Configure 方 法 时 ， 首 先 检 查 是 
售 存 在 包 盒 托管 环 境 名 称 的 方法 。 以 上 代码 添加 了 
ConfigureDevelopmentServices 方 法 ， 用 于 代替 开发 
环境 中 的 ConfigureServices 方 法 ; 还 添加 了 
ConfigureDevelopment 方 法 ， 用 于 代 蔡 开发 环境 中 
的 Configure 方 法 。 可 以 为 需要 文 持 的 每 个 环境 定义 





单独 的 方法 ， 如 条 没有 可 用 的 特定 于 环境 的 方法 ， 
则 依赖 要 调用 的 默认 方法 。 在 该 例 中 ， 
ConfigureServices 和 Configure 方 法 将 用 于 和 暂 存 环境 
与 生产 环境 。 
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如 果 定 义 了 特定 于 环境 的 方法 ， 则 不 会 调用 默 
认 方 法 。 例 如 ， 在 代码 清单 14-43 中 ，ASP.NET 
Core 不 会 在 开发 环境 中 调用 Configure 方 法 ， 因 为 有 
ConfigureDevelopment 方 法 。 这 意味 着 每 个 方法 都 
负责 环境 所 需 的 完整 配置 。 





14.73 ”创建 不 同 的 配置 类 


使 用 不 同 的 方法 意味 着 不 必 使 用 让 语句 来 检查 
托管 环境 的 名 称 ， 但 可 能 导致 类 变 得 很 大 ， 这 本 刁 
残 是 问题 。 对 于 特别 复杂 的 配置 ， 最 后 的 措施 是 为 
每 个 托管 环境 创建 不 同 的 配置 类 。 当 ASP.NET 查 找 
Startup 类 时 ， 首 先 检 碍 是 否 存在 名 称 包含 当前 托管 
环境 的 类 。 为 此 ， 在 项 目 中 添加 一 个 名 为 
StartupDevelopment.cs 的 类 文件 ， 并 用 它 定义 代码 
清单 14-44 所 示 的 类 。 





代码 清单 14-44 ”ConfiguringApps 文 件 夹 下 的 
StartupDevelopment.cs 文 件 的 内 容 





using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.DependencyInjection; 
using ConfiguringApps.Infrastructure; 


namespace ConfiguringApps { 
public class StartupDevelopment { 
public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<UptimeService>() ; 


services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 
app.UseBrowserLink(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 








这 个 类 包含 特定 于 开发 托管 环境 的 
ConfigureServices 和 Configure 方 法 。 要 使 ASP.NET 
Core 能 够 找到 特定 于 环境 的 Startup 类 ， 需 要 对 
Program 类 进行 更 改 ， 如 代码 清单 14-45 所 示 。 


代码 清单 14-45 ”在 Program.cs 文 件 中 启用 特定 于 环境 的 Startup 








using System; 

using System.Collections.Generic; 

using System. IO; 

using System. Linq; 

using System. Threading.Tasks; 

using Microsoft.AspNetCore; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.Configuration; 


using Microsoft.Extensions.Logging; 
using System.Reflection; 


namespace ConfiguringApps { 
public class Program { 


public static void Main(string[] args) { 
BuildWebHost(args).Run(); 


} 
public static IWebHost BuildWebHost(string[] ar 
gs) { 
return new WebHostBuilder() 
.UseKestrel() 
.UseContentRoot (Directory.GetCurrentDir 
ectory()) 


.ConfigureAppConfiguration( (hostingCont 
ext, config) => { 
var env = hostingContext.HostingEnv 


ironment ; 
config.AddJsonFile("appsettings.jso 
n", 
optional: true, reloadOnChange: 
true) 


.AddJsonFile($"appsettings.{env.Env 
ironmentName}.json", 
optional: true, reloadOnCha 
nge: true); 
config.AddEnvironmentVariables(); 
if (args != null) { 
config.AddCommandLine(args) ; 
} 
}) 
.ConfigureLogging((hostingContext, logg 
ing) => { 


logging.AddConfiguration( 
hostingContext.Configuration.Ge 
tSection("Logging")); 
logging.AddConsole(); 
logging.AddDebug(); 
}) 
.UseIISIntegration() 
.UseDefaultServiceProvider((context, op 
tions) => { 
options.ValidateScopes = 
context.HostingEnvironment.IsDe 
velopment(); 


}) 
.UseStartup(nameof (ConfiguringApps ) ) 


.Build(); 





UseStartup 方 法 不 指定 类 ， 而 是 给 出 应 该 使 用 
的 程序 集 的 名 称 。 当 应 用 程序 局 动 时 ，ASP.NET 将 
租 找 名 称 中 包含 托管 环境 的 类 ， 例 如 
StartupDevelopment 或 StartupProduction。 如 果 不 存 
在 ， 束 返回 使 用 和 常规 的 Startup 类 。 


14.8 ”小结 


本 章 解 释 了 如 何 配置 MVC 应 用 程序 ， 还 描述 
了 Program 和 和 Startup 类 的 作用 以 及 它们 提供 的 默认 
配置 选项 ， 展 示 了 如 何 使 用 管道 处 理 请 求 以 及 如 何 
使 用 不 同类 型 的 中 间 件 来 控制 请 求法 和 它们 引发 的 
啊 应 。 下 一 半 将 介绍 路 由 系统 ， 以 便 MVC 将 请 求 
URL 了 映射 到 控制 器 和 操作 方法 。 





15m URL H 


早期 版 本 的 ASP.NET 假 设 请 求 的 URL 与 服务 响 
人 硬盘 上 的 文件 之 间 存 在 直接 关系 。 服 务 器 的 工作 是 
从 浏览 器 接收 请 求 并 从 相应 的 文件 传递 输出 。 这 种 
方法 适用 于 Web 窗 体 ， 其 中 每 个 ASPX 页 面 都 是 文 
件 和 对 请 求 的 目 包 含 啊 应 。 





这 对 MVC 应 用 程序 来 说 并 无 意义 ， 请 求 由 控 
制 器 类 中 的 操作 方法 处 理 ， 而 且 与 硬盘 上 的 文件 也 
BA OK 








为 了 处 理 MVC 的 URL，ASP.NET 平 台 使 用 了 
路 由 系统 ， 路 由 系统 已 针对 ASP.NET Core 进 行 了 大 
量 修改 。 本 和 章 将 展示 如 何 使 用 路 由 系统 为 项 目 创建 
强大 而 灵活 的 URL 处 理 方 式 。 正 如 你 将 看 到 的 ， 路 
由 系统 允许 你 创建 所 需 的 任何 URL 模 式 ， 并 以 清晰 


简洁 的 方式 表达 它们 。 路 由 系统 有 两 个 功能 。 





。 检 查 传 入 的 URL 并 选择 控制 占 和 操作 方法 来 处 
理 请 求 。 

。 牛 成 传 出 的 URL。 这 些 是 在 视图 呈现 的 HTML 中 
显示 的 URL， 以 便 在 用 户 单 击 链接 时 调用 特定 
的 操作 (此 时 将 再 次 成 为 传 入 的 URL) 。 

















本 草 将 重点 介绍 路 由 并 使 用 它们 来 处 理 传 入 的 
URL， 以 便 用 户 可 以 访问 控制 器 和 操作 。 在 MVC 应 
用 程序 中 创建 路 由 有 两 种 方法 一 一 基于 约定 的 路 由 
和 属性 路 由 。 本 章 将 解释 这 两 种 方法 。 


然后 ， 下 一 草 将 展示 如 何 使 用 这 些 路 由 生成 包 
含 在 视图 中 的 传 出 URL， 以 及 如 何 自 定义 路 由 系统 
并 使 用 称 为 area (区 域 〉 的 相关 功能 。 表 15-1 总 结 
了 路 由 的 相关 问题 。 








表 15-1 路 由 的 相关 问题 


| | 


问题 






































有 什么 缺点 
或 限制 吗 ? 

















有 其 他 代替 
方式 吗 ? 

















ae 
漆 




















路 由 系统 负责 处 理 传 入 的 请 求 并 选择 控制 器 和 操作 方法 来 处 理 它们 。 路 由 
































系统 还 用 于 在 视图 中 生成 路 由 ， 称 为 传 出 的 URL 











路 由 系统 能 够 灵活 地 处 理 请 求 ， 而 不 是 将 URL 与 Visual Studio 项 目 中 的 类 结 
构 关联 到 一 起 























URIL 与 控制 器 和 操作 方法 之 间 的 映射 定义 在 Startup.cs 文 件 
Route 属性 应 用 于 控制 器 来 实现 



































复杂 应 用 程序 的 路 由 














日 系统 是 ASP.NET Core 的 组 成 部 分 

















表 15-2 列 出 了 本 章 要 介绍 的 操作 。 


表 15-2 本章 要 介绍 的 操作 














大 LER 码 清单 15-10 一 代码 































































































匹配 没有 相应 路 由 变量 的 UREL 片段 











将 URL 片 段 传递 给 操作 方法 





省 略 没 有 默认 值 的 URL 片 段 








定义 路 由 来 匹配 任意 数量 的 URL 片 
段 








限制 路 由 可 以 匹配 的 URL 














在 控制 器 中 定义 路 由 


























清单 15-13 一 代码 清 








定义 静态 片段 















































定义 片段 变量 











清单 15-17 一 代码 清和 




















码 清单 15-20 和 代码 清和 

















定义 可 选 片段 


























马 清单 15-22 和 代码 清 生 





($F catchall 片段 





























gy5 FA 15-24~ ARAYA 


应 用 路 由 约束 



































马 清单 15-34 一 代码 清和 























15.1 准备 示例 项 目 





本 章 将 使 用 ASP.NET Core Web 
Application (.NET Core) 模板 创建 名 为 
UrlsAndRoutes 的 Empty 项 目 。 为 了 添加 对 MVC 框 
架 、 开 发 人 员 错 误 页 面 和 项 态 文 件 的 支持 ， 将 代码 




















单 15- 


清单 15-1 显 示 的 语句 添加 到 Startup 类 中 。 


代码 清单 15-1 ”在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 配 
置 应 用 程序 


using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading.Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(); 





15.1.1 创建 模型 类 





本 章 中 的 所 有 工作 都 是 为 了 将 请 求 URL 与 操作 
相 匹 配 。 需 要 的 唯一 模型 类 会 传递 有 关 处 理 请 求 的 
控制 器 和 操作 方法 的 详细 信息 。 创 建 Models 文 件 夹 
并 添加 一 个 名 为 Result.cs 的 类 文件 ， 用 来 定义 代码 
清单 15-2 所 示 的 类 。 


代码 清单 15-2 ”Models 文 件 夹 下 的 Result.cs 文 件 的 内 容 


using System.Collections.Generic; 
namespace UrlsAndRoutes.Models { 


public class Result { 
public string Controller { get; set; } 


public string Action { get; set; } 


public IDictionary<string, object> Data { get; 


= new Dictionary<string, object>(); 





Controller 和 Action 属 性 将 用 于 指示 请 求 的 处 理 





方式 ，Data 字 上 典 将 用 于 存储 路 由 系统 生成 的 请 求 的 
其 他 详细 信息 。 


15.1.2 ”创建 Example 控 制 器 


下 面 使 用 一 些 简单 的 控制 器 来 演示 路 由 的 工作 
原理 。 创 建 Controllers 文 件 夹 并 添加 一 个 名 为 
HomeController.cs 的 类 文件 ， 其 中 的 内 容 如 代码 清 
单 15-3 所 示 。 


代码 清单 15-3 ”Controllers 文 件 夹 下 的 HomeController.cs 文 件 的 
内 容 





using Microsoft.AspNetCore.Mvc; 
using UrlsAndRoutes .Models; 


namespace UrlsAndRoutes.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() => View("Result", 
new Result { 
Controller = nameof(HomeController), 
Action = nameof( Index) 


})s 


(EH Home? iil) as HE X Index BRE 77 1 id 
View 方 法 来 演 染 名 为 Result 的 视图 (在 15.1.3 节 中 定 
义 ) ， 并 提供 Result 对 象 作为 模型 对 象 。 模 型 对 象 
的 属性 使 用 nameof 浮 数 设 置 ， 用 来 指示 已 使 用 哪个 
控制 器 和 操作 方法 来 处 理 请 求 。 














按照 相同 的 方式 ， 将 CustomerController.cs 文 件 
添加 到 Controllers 文 件 夹 中 ， 并 用 它 定 义 代码 清单 
15-4 所 示 的 Customer 控 制 器 。 





代码 清单 15-4 Controllers XF% F HJ CustomerController.cs X 
件 的 内 容 





using Microsoft.AspNetCore.Mvc; 
using UrlsAndRoutes .Models; 


namespace UrlsAndRoutes.Controllers { 
public class CustomerController : Controller { 


public ViewResult Index() => View("Result", 
new Result { 


Controller = nameof(CustomerController) 


Action = nameof( Index) 


f); 


public ViewResult List() => View("Result", 
new Result { 
Controller = nameof(CustomerController) 


Action = nameof(List) 


}); 








最 后 一 个 控制 器 定义 在 名 为 AdminController.cs 
的 文件 中 ， 将 该 文件 添加 到 Controllers 文 件 夹 中 ， 
文件 的 内 容 如 代码 清单 15-5 所 示 。 


代码 清单 15-5 “Controllers 文 件 夹 下 的 AdminController.cs 文 件 


的 内 容 





using Microsoft.AspNetCore.Mvc; 
using UrlsAndRoutes .Models; 


namespace UrlsAndRoutes.Controllers { 


public class AdminController : Controller { 


public ViewResult Index() => View("Result", 
new Result { 


Controller = nameof(AdminController), 
Action = nameof( Index) 





15.1.3 ”创建 视图 





我 们 在 15.1.2 节 定义 的 所 有 操作 方法 中 指定 了 
Result 视 图 ， 从 而 允许 创建 一 个 将 由 所 有 控制 器 共 
享 的 视图 。 创 建 Views/Shared 文 件 夹 ， 并 添加 一 个 
名 为 Result.cshtml 的 新 视图 ， 内 容 如 代码 清单 15-6 
所 示 。 


代码 清单 15-6 Views/Shared 文 件 夹 下 的 Result.cshtml 文 件 的 内 


IP 


谷 





@model Result 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Routing</title> 


<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 
<table class="table table-bordered table-striped ta 
ble-sm"> 
<tr><th>Controller:</th><td>@Model.Controller</ 
td></tr> 
<tr><th>Action:</th><td>@Model .Action</td></tr> 
@foreach (string key in Model.Data.Keys) { 
<tr><th>@key :</th><td>@Model .Data[key]</td 


></tr> 
} 
</table> 
</body> 
</html> 














Result 视 图 包含 一 个 表格 ， 其 中 显示 了 使 用 
Bootstrap 设 置 样式 的 模型 对 象 的 属性 。 为 了 回 项 目 
添加 Bootstrap， 使 用 Bower Configuration File 模 板 创 
建 bower.json 文 件 ， 并 将 Bootstrap 包 添加 到 
dependencies 部 分 ， 如 代码 清单 15-7 所 示 。 


代码 清单 15-7 在 UrlsAndRoutes 文 件 夹 下 的 bower.json 文 件 中 
添加 Bootstrap 包 





{ 


"name": "asp.net", 


"private": true, 
"dependencies": { 
"bootstrap": "4.@.0-alpha.6" 
} 
} 





最 后 的 准备 工作 是 在 Views 文 件 夹 中 创建 
_ViewImports.cshtml 文 件 ， 以 设置 用 于 Razor 视 图 的 
内 置 标签 助手 ， 并 导入 Modes 命 名 空间 ， 如 代码 清 
单 15-8 所 示 。 








代码 清单 15-8 ” Views 文件 夹 下 的 _ViewImports.cshtml 文 件 的 内 


P 


AS 


@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 

Startup 类 中 的 配置 不 包含 任何 有 关 MVC 如 何 将 
HTTP 请 求 映 射 到 控制 器 和 操作 的 说 明 。 当 运行 应 
用 程序 时 ， 请 求 的 任何 URL 都 将 得 到 404-Not Found 
响应 ， 如 图 15-1 所 示 。 





图 15-1 运行 示例 应 用 程序 的 啊 应 


15.2 ”介绍 URE 模式 


路 由 系统 使 用 一 组 路 由 来 工作 。 这 些 路 由 共同 
包含 应 用 程序 的 URL 架 构 或 方案 ， mame 
识别 和 啊 应 的 一 组 URL。 








不 需要 手动 输入 应 用 程序 中 文 持 的 所 有 单个 
URL。 相 反 ， 每 个 路 由 都 包含 一 种 URL 模 式 ， 用 来 
与 传 入 的 URL 进 行 比较 。 如 果 传 入 的 URL 与 模式 区 
配 ， 路 由 系统 将 使 用 匹配 的 模式 来 处 理 URL。 下 面 
是 一 个 人 简单 的 示例 URL: 


http://mysite.com/Admin/Index 


网 址 可 以 细 分 为 片段 。 这 些 是 URL 的 组 成 部 





分 ， 不 包括 由 /字符 分 隔 的 主机 名 和 查询 字符 串 。 在 
上 面 的 示例 URL 中 ， 有 两 个 片段 ， 如 图 15-2 所 示 。 





http://mysite.com/Admin/Index 
第 一 个 片段 第 二 个 片段 


图 15-2 示例 URL 中 的 片段 


第 一 个 片段 包含 单词 Admin， 第 二 个 片段 包含 
单词 ndex。 显 然 ， 第 一 个 片段 与 控制 器 有 关 ， 而 第 
二 个 片段 涉及 操作 。 但 是 ， 需 要 使 用 路 由 系统 可 以 
理解 的 URL 模 式 来 表达 这 种 关系 。 以 下 是 与 示例 
URL 匹 配 的 网 址 格式 : 


{controller}/{action} 


当 处 理 传 入 的 HITP 请 求 时 ， 路 由 系统 的 功能 
古 将 请 求 的 URL 与 模式 匹配 ， 并 从 URL 中 提取 模式 
中 定义 的 片段 变量 的 值 。 








片段 变量 使 用 大 括号 括 起 来 。 示 例 模 式 具 有 两 
个 名 为 controller 和 action 的 厂 段 变量 ， 因 此 controller 
片段 变量 的 值 将 为 Admin， 而 action 片 段 变量 的 值 将 
为 Index。 


MVC 应 用 程序 通常 会 有 多 个 路 由 ， 路 由 系统 
会 将 传 入 的 URL 与 每 个 路 由 的 URL 模 式 进行 比较 ， 
直到 找到 匹配 为 止 。 默 认 情 况 下 ， 一 个 模式 将 匹配 
具有 正确 片段 数量 的 任何 URL。 例 如 ， 模 式 
{fcontroller}y{faction} 将 匹配 具有 两 个 片段 的 任何 
URL， 如 表 15-3 所 示 。 


表 15-3 ”匹配 的 UREL 


























controller 片 段 变量 的 值 为 Admin，action 片段 变量 的 
值 为 Index 

















//mysite.***/Admin/Index 





//mysite.***/Admin 没有 匹配 ， 片 段 太 少 





ek //Mysite.***/Admin/Index/Soccer | 没有 匹配 ， 片 段 太 多 





表 15-3 突 出 显示 了 URL 模 式 的 两 个 关键 行为 。 





。URL 模 式 匹 配 的 片段 数 是 固定 的 。 它 们 将 仅 匹 
配 与 模式 具有 相同 数量 片段 的 URL。 表 15-3 的 第 
2 个 和 第 3 个 示例 展示 了 这 一 点 。 

。URL 模 式 匹 配 的 片段 的 内 容 是 不 固定 的 。 如 果 
URL 具 有 正确 的 片段 数 ，URL 模 式 将 提取 每 个 
片段 变量 的 值 ， 无 论 它 是 什么 。 





这 些 默 认 行 为 是 了 解 URL 模 式 如 何 运 作 的 关 
键 。 本 章 后 面 将 介绍 如 何 更 改 默 认 值 。 


15.3 ”创建 和 注册 简单 路 由 


一 旦 有 了 URL 模 式 ， 就 可 以 用 它 定义 路 由 。 路 
由 定义 在 Startup.cs 文 件 中 ， 并 作为 参数 传递 给 
UseMvc 方 法 ， 该 方法 用 于 在 Configure 方 法 中 设置 
MVC。 代 人 码 清单 15-9 显 示 了 一 个 基本 路 由 ， 用 于 将 





请 求 映 射 到 示例 应 用 程序 中 的 控制 苍 。 


代码 清单 15-9 在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 定 


义 基 本 路 由 





using 
using 
using 
using 
using 
using 
using 
using 


System; 

System.Collections.Generic; 

System.Ling; 

System. Threading.Tasks; 
Microsoft.AspNetCore. Builder; 
Microsoft.AspNetCore.Hosting; 
Microsoft.AspNetCore.Http; 
Microsoft.Extensions.DependencyInjection; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 


n services) { 


services.AddMvc(); 


} 
public void Configure(IApplicationBuilder app, 


IHostingEnvironment env) { 


app.UseDeveloperExceptionPage() ; 

app.UseStatusCodePages(); 

app.UseStaticFiles(); 

app.UseMvc(routes => { 
routes.MapRoute(name: "default", templa 


te: "{controller}/{action}"); 


}); 
} 


路 由 是 使 用 Lambda 表 达 式 创建 的 ，Lambda 表 
达 式 则 作为 参数 传递 给 UseMvc 配 置 方法 。Lambda 
表达 式 接 收 一 个 对 象 ， 它 实现 了 
Microsoft.AspNetCore.Routing 命 名 空间 中 的 
IRouteBuilder 接 口 ， 并 使 用 MapRoute 扩 展 方法 定义 
路 由 。 为 了 使 路 由 更 容易 理解 ， 约 定 在 调用 
MapRoute 扩 展 方法 时 指定 参数 名 称 ， 这 就 是 在 代码 
中 明确 命名 name 和 template 参 数 的 原因 。name 参 数 
指定 了 路 由 的 名 称 ，template 参 数 用 于 定义 模式 。 





提 示 


命名 路 由 是 可 选 的 ， 但 有 观点 认为 ， 这 样 无 法 


做 到 彻 奈 的 关注 点 分 离 。 


可 以 通过 启动 示例 应 用 程序 来 查看 这 里 对 路 由 
所 做 更 改 的 效果 。 应 用 程序 首次 启动 时 没有 变化 
你 仍 会 看 到 404 错 误 ， 但 如 果 导 航 到 与 
{controller}/{action} 模 式 匹 配 的 URL， 你 将 看 到 图 
15-3 所 示 的 结果 ， 这 表明 已 导航 到 /Admin/Index。 











图 15-3 ”使 用 简单 的 路 由 进行 导航 


应 用 程序 的 根 URL 不 起 作用 ， 原 因 是 添加 到 
Startup.cs 文 件 的 路 由 没有 告诉 MVC， 在 请 求 的 URL 
没有 厂 段 时 如 何 选 择 控 制 占 类 和 操作 方法 。15.4 市 
将 介绍 如 何 解 决 这 个 问题 。 


15.4 定义 默认 值 


请 求 默认 URL 时 ， 示 例 应 用 程序 返回 404 错 
误 ， 因 为 默认 URL 与 Startup 类 中 定义 的 路 由 模式 不 
匹配 。 由 于 默认 UREL 中 没有 可 以 与 路 由 模式 定义 的 
controller 和 action 变 量 史 配 的 片段 ， 因 此 无 法 匹配 
路 由 系统 。 








之 前 解释 过 ，URL 模 式 只 匹配 具有 指定 片段 数 
的 URL。 更 改 此 行为 的 一 种 方法 是 使 用 默认 值 。 当 
URL 不 包含 可 由 路 由 模式 匹配 的 片段 时 ， 将 应 用 的 
认 值 。 代 码 清单 15-10 定 义 了 一 个 使 用 默认 值 的 路 
由 。 











代码 清单 15-10 ”在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 
提供 默认 值 





using System; 

using System.Collections.Generic; 
using System.Ling; 

using System. Threading. Tasks; 


using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc (routes => { 
routes .MapRoute( 
name: "default", 
template: "{controller}/{action}", 
defaults: new { action = "Index" }); 





默认 值 可 作为 匿名 类 型 的 属性 提供 ， 并 作为 
defaults 参 数 传递 给 MapRoute 方 法 。 在 以 上 代码 
中 ， 为 action 变 量 提供 了 默认 值 Index。 








这 个 路 由 将 匹配 所 有 两 段 式 URL， 束 像 以 前 一 
样 。 例 如 ， 如 果 请 求 
reek &KK //ydomain.***/Home/Index, Be FTE HL 
Home 作 为 controller 变 量 的 值 ， 并 将 提取 Index 作 为 
action 变 量 的 值 。 


但 是 现在 action 变 量 有 了 默认 值 ， 路 由 也 将 匹 
配音 片段 URL。 当 处理 单 片段 URL 时 ， 路 由 系统 将 
从 UREL 中 提取 controller 变 量 的 值 ， 并 使 用 action 变 
量 的 默认 值 。 通 过 这 种 方式 ， 用 户 在 请 求 /Home 的 
时 候 ，MVC 将 在 Home 控 制 器 上 调用 Index 操 作 方 
法 ， 如 图 15-4 所 示 。 





图 15-4 ”使 用 默认 的 操作 方法 


定义 内 联 默认 值 


默认 值 也 可 以 表示 为 URL 模 式 的 一 部 分 ， 这 是 
一 种 更 简洁 的 表达 路 由 的 方式 ， 如 代码 清单 15-11 
所 示 。 内 联 语法 只 能 为 URL 模 式 的 部 分 变量 提供 默 
认 值 ， 但 是 ， 正 如 你 将 了 解 到 的 那样 ， 能 够 在 这 种 
模式 之 外 提供 默认 值 通 常 很 有 有 用。 因此， 了解 表达 
默认 值 的 两 种 方法 是 很 有 用 的 。 














代码 清单 15-11 ”在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 
定义 内 联 默认 值 





uSing System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 


services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes .MapRoute( 
name: "default", 
template: "{controller}/{action=Ind 





可 以 进一步 匹配 完全 不 包含 任何 片段 变量 的 
URL， 仅 依靠 默认 值 来 标识 action 和 controller。 作 
为 示例 ， 代 码 清 单 15-12 显 示 了 如 何 通过 为 两 个 片 
段 提供 默认 值 来 映射 应 用 程序 的 根 URL。 


代码 清单 15-12 ”在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 
提供 默认 值 





using System; 
using System.Collections.Generic; 
using System.Ling; 


using System.Threading.TasKs ; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 

app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 

routes .MapRoute( 

name: "default", 
template: "{controller=Home}/{action=In 


dex}"); 





通过 为 controller 和 action 变 量 提 供 默 认 值 ， 路 
由 将 匹配 具有 和 零 个 、 一 个 或 两 个 片段 的 URL， 如 表 
15-4 上 所 示 。 





表 15-4 匹配 UREL 


a 








controller = Customer, action = Index 
T /Customer/List controller = Customer, action = List 
a /Customer/List/All 有 匹配 ， 片 段 太 多 


传 入 的 URL 中 接收 的 片段 越 少 ， 路 由 越 依赖 于 
默认 值 ， 下 到 仪 使 用 默认 值 匹配 没有 片段 的 URL。 

















可 以 通过 局 动 示 例 应 用 程序 来 租 看 默认 值 的 效 
末 。 当 浏 抽 右 请 求 应 用 程序 的 根 URL 时 ， 将 使 用 
controller 和 action 片 段 变 量 的 默认 值 ， 这 将 导致 
MVC 在 Home 控 制 嚣 上 调用 Index 操 作 方 法 ， 如 图 
15-5 所 示 。 





图 15-5 “使 用 默认 值 扩大 路 由 范围 
15.5 ”使 用 静态 URE 请 段 


并 非 URE 格 式 中 的 所 有 片段 都 必须 是 变量 。 还 
可 以 创建 具有 静态 片段 的 模式 。 假 设 应 用 程序 需要 
匹配 以 Public 为 前 缀 的 UREL， 如 下 所 示 : 


****: / /mydomain. ***/Public/Home/ Index 


这 可 以 通过 使 用 代码 清单 15-13 所 示 的 URL 模 








代码 清单 15-13 在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 
使 用 静态 片段 


using System; 
using System.Collections.Generic; 


using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 
n=Index}"); 
routes.MapRoute(name: "" 
template: "Public/{controller=Home} 


/{action=Index}") ; 
}); 





这 种 新 酝 式 将 仅 匹 配 包含 3 个 户 段 的 URL， 第 


一 个 片段 必须 为 Public。 其 他 两 个 片段 可 以 包含 任 


何 值 ， 


并 将 用 于 controller 和 action 变 量 。 如 果 省 上 略 


最 后 两 个 片段 ， 将 使 用 默认 值 。 





还 可 以 创建 包含 静态 和 可 变 元 素 的 片段 的 URL 


模式 ， 


如 代码 清单 15-14 所 示 。 


代码 清单 15-14 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 的 


混合 万 段 





using 
using 
using 
using 
using 
using 
using 
using 


System; 

System.Collections.Generic; 

System. Ling; 

System. Threading.Tasks; 
Microsoft.AspNetCore. Builder; 
Microsoft.AspNetCore.Hosting; 
Microsoft.AspNetCore.Http; 
Microsoft.Extensions.DependencyInjection; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 


n services) { 


services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes.MapRoute("", "X{controller}/{act 


ion}"); 
routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 
n=Index}"); 


routes.MapRoute(name: "", 
template: "Public/{controller=Home } 
/{action=Index}") ; 
})3 





这 个 路 由 中 的 模式 能 匹配 任何 两 片段 的 URL， 
其 中 第 一 个 请 段 以 字母 X 开 头 。controller 的 值 取 目 
第 一 个 片段 ， 不 包括 X。action 的 值 取 自 第 二 个 片 
段 。 如 采 局 动 应 用 程序 并 导航 到 /XHome/Index， 路 
由 效果 如 图 15-6 所 示 。 





x 
€ > S |O localhost:54839/XHome/Index vw i 








Controller: HomeController 
Index 





图 15-6 ”在 单个 片段 中 混合 静态 和 可 变 元 素 的 路 由 效果 


路 由 排序 


代码 清单 15-14 定 义 了 一 个 新 的 路 由 并 将 其 放 
在 所 有 其 他 路 由 之 前 。 这 样 做 是 为 了 让 路 由 按照 定 
义 的 顺序 应 用 。MapRoute 方 法 将 路 由 添加 到 路 由 配 
BNA, KARE ER A SIZE INI 
用 。 之 所 以 说 “通常 ”， 是 因为 有 一 些 方法 还 可 以 在 
特定 位 置 插 入 路 由 。 不 建议 使 用 这 些 方法 ， 因 为 按 
照 定 义 的 顺序 应 用 路 由 能 够 使 应 用 程序 的 路 由 更 容 
易 理 解 。 





路 由 系统 答 试 对 传 入 的 UREL 与 首先 定义 的 路 由 





的 URL 模 式 进行 岂 配 ， 只 有 在 没有 匹配 时 才 进 入 下 
一 个 路 由 。 这 些 路 由 按 顺 序 和 尝试 ， 直 到 找到 风 配 的 
路 由 或 路 由 被 用 完 。 因 此 ， 必 须 首先 定义 最 具体 的 
路 由 。 代 码 清单 15-14 添 加 的 路 由 比 后 面 的 路 由 更 
具体 。 假 设 题 倒 路 由 的 顺序 ， 如 下 所 示 : 


routes.MapRoute("MyRoute", "{controller=Home}/{action=I 
ndex}"); 





routes.MapRoute("", "X{controller}/{action}"); 


然后 ， 第 一 个 路 由 能 够 匹配 任何 具有 和 零 个 、 一 
个 或 两 个 片段 的 URL， 因 而 将 始终 使 用 。 更 具体 的 
路 由 ， 比 如 上 述 代 码 中 的 第 二 个 路 由 ， 则 永远 不 会 
使 用 。 新 路 由 排除 了 URL 的 前 导 X， 但 旧 路 由 不 会 
这 样 做 。 因 此 ， 像 下 面 这 样 的 URL: 


http://mydomain.com/XHome/Index 
将 被 定位 到 名 为 XHome 的 控制 器 ， 我 们 假设 应 





用 程序 中 有 XHomeController 类 ， 并 且 有 名 为 Index 
WIPE VETTE 


UR AY UAS RESURLARI SAME AA ER E 
URL 的 别名 。 使 用 的 URL 模 式 在 部 署 应 用 程序 时 与 
用 户 形 成 了 约定 ， 如 果 随 后 重 构 应 用 程序 ， 则 需要 
保留 以 前 的 URL 模 式 ， 以 便 用 户 创 建 的 任何 URL 收 
藏 来 、 宏 或 脚本 能 够 继续 工作 。 








想象 一 下 ， 以 前 有 一 个 名 为 Shop 的 控制 项 ， 现 
在 已 被 Home 控 制 疮 取代 了 。 人 代码 清单 15-15 显 示 了 
如 何 创建 保留 旧 URL 模 式 的 路 由 。 


代码 清单 15-15 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 的 
片段 和 默认 值 





using System; 
using System.Collections.Generic; 
using System.Ling; 


using System.Threading.TasKs ; 

using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes .MapRoute( 
name: "ShopSchema", 
template: "Shop/{action}", 


defaults: new { controller = "Home" 
})3 
routes.MapRoute("", "X{controller}/{act 
ion}"); 
routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 
n=Index}"); 


routes .MapRoute(name: 
template: "Public/{controller=Home } 


/{action=Index}"); 
})5 


} 
} 


} 





以 上 加 粗 显 示 的 路 由 能 匹配 任何 两 个 片段 的 
URL， 其 中 第 一 个 片段 是 Shop。action 的 值 取 自 第 
二 个 URL 片 段 。URL 模 式 不 包含 controller 的 变量 片 
段 ， 因 此 使 用 默认 值 。defaults 参 数 提供 了 controller 
的 值 ， 因 为 没有 厂 段 能 够 将 值 作为 URL 模 式 的 一 部 
分 应 用 于 该 URL 模 式 。 





其 结果 是 ，Shop 控 制 妖 上 的 操作 请 求 被 转换 为 
对 Home 控 制 器 的 请 求 。 可 以 通过 局 动 应 用 程序 并 
导航 到 /Shop/Index 来 查看 路 由 效果 。 如 图 15-7 所 
示 ， 新 路 由 使 MVC 在 Home 控 制 器 中 定位 到 Index 操 
TE 











[} Routing 


所 C |© localhost ty : 


Controller: HomeController 


Action: Index 


图 15-7 创建 别名 以 保留 URL 模 式 


可 以 更 进一步 ， 为 已 经 重 构 并 有 旦 控制 器 中 己 不 
存在 的 操作 方法 创建 别名 。 为 此 ， 创 建 一 个 静态 
URL， 并 提供 controller 和 action 的 默认 值 ， 如 代码 
清单 15-16 所 示 。 


代码 清单 15-16 在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 


为 controller 和 action 使 用 别名 





using 
using 
using 
using 
using 
using 
using 
using 


System; 

System.Collections.Generic; 

System. Ling; 

System. Threading. Tasks; 
Microsoft.AspNetCore. Builder; 
Microsoft.AspNetCore.Hosting; 
Microsoft.AspNetCore.Http; 
Microsoft.Extensions.DependencyInjection; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 


routes .MapRoute( 
name: "ShopSchema2", 
template: "Shop/OldAction", 
defaults: new { controller = "Home" 
» action = "Index" }); 
routes .MapRoute( 
name: "ShopSchema", 
template: "Shop/{action}", 


defaults: new { controller = "Home" 
})3 
routes .MapRoute("", "X{controller}/{act 
ion}"); 
routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 
n=Index}"); 


routes .MapRoute(name: 
template: "Public/{controller=Home } 
/{action=Index}") ; 
})3 
} 


pe 
} 

请 注意 ， 首 先 要 定义 新 路 由 ， 因 为 它 比 后 面 的 
路 由 更 具体 。 人 例如， 如果 对 Shop/OldAction 的 请 求 
由 下 一 个 定义 的 路 由 处 理 ， 并 且 有 一 个 带 有 
OldAction 操 作 方 法 的 控制 器 ， 则 可 能 无 法 得 到 想 要 
的 结果 。 





15.6 定义 目 定 义 片 段 变量 


controller 和 和 action 片 段 变 量 在 MVC 应 用 程序 中 
其 有 特殊 含义 ， 相 当 于 为 请 求 提供 服务 的 控制 器 和 
操作 方法 。 这 些 只 是 内 置 的 请 段 变量 ， 也 可 以 定义 
目 定 义 片 段 变量 ， 如 代码 清单 15-17 所 示 《〈 这 里 已 
经 删除 了 已 有 路 由 ， 以 便 重 新 开始 ) 。 








代码 清单 15-17 在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 
定义 其 他 变量 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 

IHostingEnvironment env) { 

app.UseDeveloperExceptionPage(); 

app.UseStatusCodePages(); 

app.UseStaticFiles(); 

app.UseMvc(routes => { 

routes .MapRoute(name: “MyRoute", 
template: "{controller=Home}/{actio 

n=Index}/{id=DefaultId}") ; 

})3 





以 上 代码 中 的 URL 模 式 定 义 了 标准 的 controller 
和 action 变 量 ， 以 及 名 为 id 的 自 定 义 变量 。 路 由 将 四 


配 0 一 3 个 片段 的 UREL。 第 3 个 片段 的 内 容 将 分 配给 id 
变量 ， 如 果 没 有 第 3 个 片段 ， 就 使 用 默认 值 。 





Ms 


Æ 
H 





茶 些 名 称 是 保留 的 ， 不 适合 作为 目 定义 卢 段 变 
量 的 名 称 ， 它 们 是 controller、action 、area 和 page， 
前 两 个 名 称 的 含义 是 显而易见 的 。area、page 由 
Razor 页 面 的 使 用 ， 本 书 将 在 下 一 章 解 释 。 


Controller 类 是 控制 器 的 基础 ， 它 定义 了 
RouteData 属 性 ， 访 属性 返回 一 个 


Microsoft.AspNetCore.Routing. RouteDataX} &, 1% 





对 象 提供 有 关 路 由 系统 的 详细 信息 以 及 当前 请 求 的 
路 由 方式 。 在 控制 器 中 ， 可 以 使 用 
RouteData.Values 属 性 访问 操作 方法 中 的 任何 万 段 
变量 ， 该 属性 会 返回 一 个 包含 厂 段 变量 的 字典 。 为 
了 演示 ， 这 里 在 Home 控 制 费 中 添加 一 个 名 为 
CustomVariable 的 操作 方法 ， 如 代码 清单 15-18 所 
ZN o 











代码 清单 15-18 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 访问 片段 变量 





using Microsoft.AspNetCore.Mvc; 
using UrlsAndRoutes .Models; 


namespace UrlsAndRoutes.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() => View("Result", 
new Result { 
Controller = nameof(HomeController), 
Action = nameof(Index) 


}); 


public ViewResult CustomVariable() { 
Result r = new Result { 


Controller = nameof(HomeController), 
Action = nameof(CustomVariable), 


}; 
r.Data["Id"] = RouteData.Values["id"]; 
return View("Result", r); 





操作 方法 CustomVariable 使 用 RouteData.Values 
属性 获取 路 由 URL 模 式 中 的 目 定 义 片 段 变 量 id 的 
值 ，RouteData.Values 属 性 则 返回 路 由 系统 生成 的 
变量 字典 。 目 定义 所 段 变量 将 被 添加 到 视图 模型 对 
象 中 ， 可 以 通过 运行 应 用 程序 并 请 求 以 下 URL 来 查 
看 : 


/Home/CustomVariable/Hello 


路 由 模板 对 以 上 URL 中 的 第 3 个 片段 与 id 变量 
的 值 进行 匹配 ， 产 生 图 15-8 所 示 的 结果 。 














口 Routing 


一 Œ | © localhost:54839/Home/CustomVariable/Hello 家 | i 
Controller: HomeController 

Action: CustomVariable 

Id: Hello 





图 15-8 ”显示 自 定义 片段 变量 的 值 


代码 清单 15-17 中 的 URL 模 式 定 义 了 id 变 量 的 默 
认 值 ， 这 意味 着 路 由 也 可 以 匹配 具有 两 个 片段 的 
URL。 可 以 通过 请 求 如 下 URL 来 查看 如 何 使 用 默认 
值 : 


/Home/CustomVariable 


路 由 系统 使 用 上 自 定 义 片 段 变 量 的 默认 值 ， 如 图 
15-9 上 所 示 。 





Controller: HomeController 


Action: CustomVariable 


Id: Defaultid 





图 15-9 ” 目 定 义 片 段 变量 的 默认 值 


使 用 上 自 定义 片段 变量 作为 操作 方法 的 参 





使 用 RouteData. — SR ÆW le) BE SC 
Bae MTS, AT SUT EEE. WR 
操作 wwe 的 参数 ， 
MVC 将 把 自动 从 URL 获 取 的 值 作为 参数 传递 给 操作 
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在 代码 清单 15-17 所 示 的 路 由 中 定义 的 自 定义 
片段 变量 名 为 id。 这 里 可 以 修改 Home 控 制 磊 中 的 
CustomVariable 操 作 方 法 ， 使 其 具有 相同 名 称 的 参 
数 ， 如 代码 清单 15-19 所 示 。 





代码 清单 15-19 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 添加 action 参 数 


using Microsoft.AspNetCore.Mvc; 
using UrlsAndRoutes .Models; 


namespace UrlsAndRoutes.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() => View("Result", 
new Result { 
Controller = nameof(HomeController), 
Action = nameof (Index) 


}); 


public ViewResult CustomVariable(string id) { 
Result r = new Result { 
Controller = nameof(HomeController), 
Action = nameof(CustomVariable), 


}; 
r.Data["Id"] = id; 
return View("Result", r); 





当 路 由 系统 对 UREL 与 代码 清单 15-17 中 定义 的 
路 由 进行 匹配 时 ，URL 中 第 3 个 片段 的 值 将 被 分 配 
给 自 定义 片段 变量 ide MVC 对 片段 变量 的 列表 与 
操作 方法 的 参数 列表 进行 比较 ， 如 果 名 称 匹 配 ， 就 
将 值 从 URL 传 递 给 操作 方法 。 


id 参数 的 类 型 是 字符 串 ， 但 MVC 会 答 试 将 URL 
值 转换 为 使 用 的 任何 参数 类 型 。 如 果 操 作 方 法 将 id 
参数 声明 为 int 或 DateTime， 那 么 MVC 将 从 URL 中 
接收 值 并 转换 为 相应 类 型 。 这 是 一 个 优雅 而 实用 的 
功能 ， 无 须 自 己 处 理 转换 。 可 以 通过 启动 应 用 程序 
并 请 求 /Home/CustomVariable/Hello 来 查看 操作 方法 
参数 的 效果 ， 从 而 生成 图 15-10 所 示 的 结果 。 如 果 
省 略 第 3 个 片段 ， 将 为 操作 方法 提供 默认 厂 段 值 。 








图 15-10 ”使 用 操作 方法 参数 访问 片段 变量 的 结 来 


E 


v> ae 
ce, Je 


MVC 使 用 模型 绑 定 功能 将 UREL 中 包含 的 值 转 
换 为 .NET 类 型 ， 模 型 绑 定 还 可 以 处 理 比 此 例 更 复杂 
的 情况 。 第 26 间 将 介绍 模型 绑 定 。 





15.6.2 ”定义 可 选 的 URE 片段 








可 选 的 URL 厂 段 是 用 户 不 需要 指定 的 URL 厂 
段 ， 而 且 没 有 指定 默认 值 。 可 选 片 段 由 片段 名 称 后 
面 的 问号 (? 字 符 〉 表 示 ， 如 代码 清单 15-20 所 示 。 


代码 清单 15-20 ”在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 
指定 可 选 片 段 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes.MapRoute(name: "MyRoute", 
template: "{controller=Home}/{action=In 


dex}/{id?}"); 








无 论 是 人 否 已 提供 id 片段 ， 以 上 路 由 都 将 匹配 
URL。 表 15-5 显 示 了 可 选 片段 如 何 适用 于 不 同 的 
URL. 





4215-5 ”使 用 可 选 片 段 变量 匹配 UREL 





0 / controller = Home, action = Index 


/Customer/List controller = Customer, action = List 


/Customer/List/All controller = Customer, action = List id = All 
/Customer/List/All/Delete 没有 匹配 ， 片 段 太 多 





从 表 15-5 可 以 看 出 ， 只 有 当 传 入 的 URL 中 存在 
相应 的 片段 时 ， 才 会 将 id 变量 添加 到 变量 集合 中 。 
如 采 需 要 知道 用 户 是 否 为 片段 变量 提供 了 值 ， 这 个 
功能 将 非常 有 用 。 如 果 没 有 为 可 选 片段 变量 提供 
值 ， 相 应 参数 的 值 将 为 mul。 在 代码 清单 15-21 中 ， 
因为 没有 为 id 片段 变量 提供 值 ， 所 以 更 新 了 Home 控 
制 器 以 进行 啊 应 。 











代码 清单 15-21 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 检查 片段 


using Microsoft.AspNetCore.Mvc; 
using UrlsAndRoutes .Models; 


namespace UrlsAndRoutes.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() => View("Result", 
new Result { 


Controller = nameof(HomeController), 
Action = nameof(Index) 


}); 


public ViewResult CustomVariable(string id) { 
Result r = new Result { 
Controller = nameof(HomeController), 
Action = nameof(CustomVariable), 


}; 
r.Data["Id"] = id ?? "<no value>"; 
return View("Result", r); 








图 15-11 显 示 了 局 动 应 用 程序 并 导航 
到 /Home/CustomVariable URL 的 结果 ， 这 个 URL 不 
包含 id 片段 变量 的 值 。 





[M Routing x 


a CŒ | © localhost:54 


Controller: HomeController 


Action: CustomVariable 


Id: 


<no value> 


图 15-11 检测 URL 何 时 不 包含 可 选 片 段 变量 的 值 





理解 默认 的 路 由 配置 


将 添加 MVC 到 Startup 类 时 ， 可 以 使 用 
UseMvcWithDefaultRoute 方 法 执行 此 操作 。 这 只 是 
设置 最 闸 见 路 由 配置 的 便捷 方法 ， 相 当 于 以 下 代 
4: 


app.UseMvc(routes => { 
routes .MapRoute( 
name: "default", 


template: "{controller=Home}/{action=Index}/{id 





默认 配置 匹配 按 名 称 定 位 控制 器 类 和 操作 方法 
的 URL， 并 带 有 可 选 的 id 片段 。 如 果 控 制 器 或 操作 
片段 丢失 ， 则 默认 值 分 别 用 于 定位 Home 控 制 器 和 





Index 操 作 方 法 。 


15.6.3 ”定义 可 变 长 上 度 路 由 


更 改 URL 模 式 的 默认 保守 性 的 男 一 种 方法 是 接 
收 可 变数 量 的 URE 片 段 ， 这 人 允许 你 在 单个 路 由 中 匹 
配 任意 长 度 的 URL。 可 以 通过 将 其 中 一 个 片段 变量 
指定 为 catchall 来 定义 对 变量 卢 段 的 文 持 ， 可 通过 在 
其 前 面 添加 星 号 〈* 字 符 ) 来 完成 ， 如 代码 清单 15- 
22 所 示 。 


代码 清单 15-22 ”在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 
指定 catchall 变 量 





using Microsoft.AspNetCore. Builder; 
using Microsoft.Extensions.DependencyInjection; 


namespace UrlsAndRoutes { 


public class Startup { 
public void ConfigureServices(IServiceCollectio 


n services) { 
services.AddMvc(); 


} 
public void Configure(IApplicationBuilder app) 


app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes.MapRoute(name: "MyRoute", 
template: "{controller=Home}/{action=In 
dex}/{id?}/{*catchall}"); 


3 





这 里 通过 扩展 前 一 个 例子 中 的 路 由 来 添加 
catchall 片 段 变 量 ，catchall 是 一 个 十 分 富有 想象 力 的 
名 称 。 这 个 路 由 现在 将 匹配 任何 URL， 而 无 论 其 包 
售 多 少 片段 以 及 这 些 片 段 的 值 如 何 。 前 3 个 卢 段 分 
别 用 于 设置 controller、action 和 id 变量 的 值 。 如 果 
URL 包 含 其 他 刻 段 ， 则 把 它们 都 分 配给 catchall 变 
量 ， 如 表 15-6 所 示 。 








表 15-6 ”使 用 catchall 变 量 匹 配 UREL 




















controller = 再 ome, action = Index 
controller = Customer, action = Index 
/Customer/List controller = Customer, action = List 


/Customer/List/All controller = Customer, action = List id = All 


controller = Customer, action = List id = All catchall 


/Customer/List/All/Delete 
= Delete 


controller = Customer, action = List id = All catchall 
/Customer/List/All/Delete/Perm 


= Delete/Perm 





代码 清单 15-23 更 新 了 Customer 控 制 器 ， 以 便 
List 操 作 通 过 模型 对 象 将 catchall 变 量 的 值 传递 给 视 
图 。 


代码 清单 15-23 ”更 新 Controllers 文 件 夹 下 的 
CustomerController.cs 文 件 中 的 操作 方法 


using Microsoft.AspNetCore.Mvc; 


using UrlsAndRoutes.Models; 


namespace UrlsAndRoutes.Controllers { 
public class CustomerController : Controller { 


public ViewResult Index() => View("Result", 
new Result { 
Controller = nameof(CustomerController) 


Action = nameof (Index) 

}); 

public ViewResult List(string id) { 

Result r = new Result { 
Controller = nameof(HomeController), 
Action = nameof(List), 

}; 

r.Data["Id"] = id ?? "<no value>"; 

r.Data["catchall"] = RouteData.Values[ "catc 

hall"]; 


return View("Result", r); 





要 疯 试 catchall 厂 段 ， 请 运行 应 用 程序 并 请 求 以 
FURL: 


/Customer/List/Hello/1/2/3 


以 上 路 由 中 的 URL 模 式 将 匹配 的 片段 数量 没有 





上 限 。 图 15-12 显 示 了 catchall 片 段 的 效果 。 请 注 
意 ，catchall 捕 获 的 片段 以 segment/segment/segment 
的 形式 显示 ， 并 且 需 要 处 理 字符 串 以 分 解 各 个 厂 


FX o 





图 15-12 ”使 用 catchall 片 段 


15.7 约束 路 由 


URL 模 式 在 匹配 URL 中 的 片段 数 时 是 保守 的 ， 
当 它 们 与 片段 的 内 容 匹 配 时 是 自由 的 。 前 几 节 已经 
解释 了 控制 保守 程度 的 不 同 技术 一 一 使 用 默认 值 、 
可 选 变量 等 使 路 由 匹配 更 多 或 更 少 的 片段 。 











现在 来 看 看 如 何 控制 匹配 URE 廊 段 内 容 的 目 由 


上 度 ， 也 束 是 如 何 限制 路 由 将 匹配 的 URE 人 集合。 代码 
清单 15-24 演 示 了 如 何 使 用 简单 约束 来 限制 路 由 匹 
配 的 URL。 


代码 清单 15-24 ”在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 
约束 路 由 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 


routes .MapRoute(name: "MyRoute", 
template: "{controller=Home}/{action=In 
dex}/{id:int?}"); 
}); 


} 
} 


} 





GAS GC 字符 ) 将 约束 与 片段 变量 名 分 
开 。 以 上 代码 中 的 约束 是 int， 已 应 用 于 id 片段 。 这 
古 一 个 内 联 约束 ， 且 被 定义 为 URL 模 式 的 一 部 分 ， 
IFA HRS Hr R: 


template: "{controller}/{action}/{id:int?}", 





int 约 束 仅 允 许 URL 模 式 匹配 值 可 以 解析 为 整数 
值 的 卢 段 。id 卢 段 是 可 选 的 ， 因 此 路 由 将 匹配 省 略 
了 id 的 片段 ， 但 如 果 所 段 存在 ， 那 么 id 必须 是 整数 
值 ， 如 表 15-7 所 示 。 


表 15-7 使 用 约束 匹配 URL 
[| 

















示例 URL 匹配 结果 


controller = Home, action = Index, id = null 


/Home/CustomVariable/Hello 没有 匹配 ，id 片 段 无 法 被 解析 为 int 值 


























/Home/CustomVariable/1 controller = Home, action = CustomVariable, id = 1 


/Home/CustomVariable/1/2 没有 匹配 ， 片 段 太 多 








在 定义 路 由 时 ， 也 可 以 使 用 MapRoute 方 法 的 
constraints 参 数 在 URL 模 式 之 外 指定 约束 。 如 采 和 硕 
望 将 URL 模 式 与 其 约束 分 开 ， 或 者 更 喜欢 早期 版本 
的 MVC “〈 不 文 持 内 联 约束 ) 所 使 用 的 路 由 样式 ， 那 
么 这 种 方法 很 有 和 用。 代码 清单 15-25 显 示 了 相同 的 id 
厂 段 变量 的 整数 约束 ， 可 使 用 单独 的 约束 来 表示 。 
使 用 这 种 格式 时 ， 默 认 值 也 在 外 部 表示 。 


代码 清单 15-25 在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 
表达 约束 


using System; 
using System.Collections.Generic; 


using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.AspNetCore.Routing.Constraints; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes .MapRoute(name: "MyRoute", 
template: "{controller}/{action}/{id?}", 


defaults: new { controller = "Home", ac 
tion = "Index" }, 
constraints: new { id = new IntRouteCon 


straint() }); 
}); 





MapRoute 方 法 的 constraints 参 数 是 使 用 匿名 类 
型 定义 的 ， 匿 名 类 型 的 属性 名 称 对 应 于 受 约束 的 睫 
段 变 量 。Microsoft.AspNetCore.Routing.Constraints 
命名 空间 包含 一 组 可 用 于 定义 各 个 约束 的 类 。 在 代 
码 清单 15-25 中 ，constraints 参 数 被 配置 为 对 id 片段 
使 用 IntRouteConstraint 对 象 ， 以 创建 与 代码 清单 15- 
24 所 示 的 内 联 约束 相同 的 效果 。 














表 15-8 摘 述 了 Microsoft.AspNetCore.Routing 命 
名 空间 中 完整 的 约束 类 。Constraints 命 名 空间 及 等 
效 的 内 联 约 束 可 以 应 用 于 URL 模 式 中 的 单个 厂 段 ， 
后 面 的 章 市 将 摘 述 其 中 一 些 情况 。 








o 


提 示 


可 以 使 用 MVC 提 供 的 一 组 特性 (例如 HttpGet 
和 HttpPost 特 性 ) 对 使 用 特定 HTTP 谓词 〈 例 如 GET 
或 POST) 请 求 的 操作 方法 进行 限制 。 有 关 使 用 这 
些 特性 处 理 控制 器 中 表单 的 详细 信息 ， 请 参阅 第 7 
章 ， 有 关 此 类 可 用 特性 的 完整 列表 ， 请 参阅 第 20 


Ne 
i 








4215-8 片段 级 路 由 约束 


匹配 字母 字符 ， 无 论 大 小 写 
alpha AlphaRouteConstraint() 
(A~Z, a~z) 
匹配 可 以 解析 为 bool 类 型 的 值 | BoolRouteConstraint() 




















匹配 可 以 解析 为 DateTime 类 

datetime DateTimeRouteConstraint() 
匹配 可 以 解析 为 decimal 类 型 的 

decimal DecimalRouteConstraint() 





匹配 可 以 解析 为 double 类 型 的 
double 值 DoubleRouteConstraint() 


匹配 可 以 解析 为 float 类 型 的 值 | FloatRouteConstraint() 





匹配 GUID 值 GuidRouteConstraint() 

















匹配 可 以 解析 为 int 类 型 的 值 IntRouteConstraint() 























ERÈ, LengthRouteConstraint(len) 


























length(len)/length(min,max) | 或 者 匹 TZ 于 最 小 和 | LengthRouteConstraint(min, 























eZ IE max) 

















匹配 可 以 解析 为 long 类 型 的 值 | LongRouteConstraint() 





匹配 字符 数量 不 超过 len 的 字符 , 
maxlength(len) MaxLengthRouteConstraint(len) 


串 


配置 一 个 int 值 ， 该 值 小 于 MaxRouteConstraint(val) 


匹配 字符 数量 至 少 为 len 的 字符 | 
minlength(len) MinLengthRouteConstraint(len) 


串 


匹配 一 个 int 值 ， 该 值 大 于 MinRouteConstraint(val) 


匹配 一 个 int 值 ， 该 值 介 于 mi RangeRouteConstraint(min, 


range(min,max) 和 max 之 间 masi 



























































regex(expr) 匹配 正则 表达 式 RegexRouteConstraint(expr) 


15.7.1 使 用 正则 表达 式 约束 路 由 


正则 表达 式 提 供 了 灵活 性 最 大 的 约束 ， 可 使 用 
正则 表达 式 匹 配 片 段 。 代 码 清 单 15-26 对 controller 片 
段 进 行 了 约束 以 限制 匹配 的 URE 范 围 。 


代码 清单 15-26 在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 
使 用 正则 表达 式 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.AspNetCore.Routing.Constraints; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


l 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes .MapRoute(name: "MyRoute", 
template: "{controller:regex(“H.*)=Home 
}/{action=Index}/{id?}"); 


3 





以 上 代码 使 用 约束 来 限制 路 由 ， 使 路 由 只 匹配 
controller 片 段 以 字母 H 开 头 的 UREL。 


在 检查 约束 之 前 会 应 用 默认 值 。 因 此 ， 举 例 来 
说 ， 如 果 请 求 URL /， 束 应 用 controller 的 默认 值 


Home。 然 后 检查 约束 ， 并 且 由 于 controller 的 值 以 H 
开头 ， 因 此 默认 URE 将 匹配 路 由 。 


正则 表达 式 可 以 约束 路 由 ， 以 便 只 有 UREL I Ex 
的 特定 值 才能 匹配 。 这 是 使 用 竖 线 (|) 字符 完成 
的 ， 如 代码 清单 15-27 所 示 《〈 这 里 将 URL 模 式 拆 分 
成 两 行 以 适应 纸 面 宽度 ， 在 实际 项 目 中 不 用 这 人 么 
做 ) 。 








代码 清单 15-27 在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 
约束 路 由 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.AspNetCore.Routing.Constraints; 


namespace UrlsAndRoutes { 


public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes.MapRoute(name: "MyRoute", 
template: "{controller: regex(‘H.*)=Ho 
me}/" 
+ "{action: regex (“*Index$ | *About$) =I 


ndex}/{id?}"); 
}); 





以 上 约束 允许 路 由 仅 匹 配 action 片 段 的 值 为 
Index 或 About 的 URL。 由 于 约 ee ee: 
此 需要 组 合 action 变 量 与 controller 变 量 的 限制 。 
RRAIN “controller® Œ FAHI a 
为 mdex 或 About 时 ， 代 码 清 单 15-27 中 的 路 由 才能 匹 
ACURL. 


15.7.2 ”使 用 类 型 和 值 约束 


大 多 数 约束 用 于 限制 路 由 ， 因 此 它们 仅 匹 配 有 具 
有 可 转换 为 指定 类 型 或 具有 特定 格式 的 片段 的 
URL。 本 节 开 头 使 用 的 int 约 束 是 一 个 很 好 的 例子 : 
只 有 当 受 约束 的 片段 的 值 可 以 解析 为 .NET 的 int 值 
时 ， 才 会 匹配 路 由 。 代 码 清单 15-28 演 示 了 range 约 
束 的 用 法 ， 对 路 由 进行 限制 ， 只 有 当 一 个 片段 值 可 
以 转换 为 int 类 型 并 且 介 于 指定 值 之 间 时 才 匹 配 
URL. 








代码 清单 15-28 在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 
基于 类 型 和 值 进行 约束 








using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.AspNetCore.Routing.Constraints; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes .MapRoute(name: "MyRoute", 
template: "{controller=Home}/{action=In 
dex}/{id:range(10, 20) ?}"); 


3 





LEB PA ADR CMP ay ee id Bx. BUFR 
We 
段 ， 那 么 仅 当 所 段 值 可 以 转换 为 int 类 型 且 介 于 10 一 
20K, KET VL ACURL. aan 
也 就 是 说 ，10 和 20 也 被 认为 处 在 约束 范围 内 。 


15.73 HEAR 








如 果 需 要 将 多 个 约束 应 用 于 单个 片段 ， 可 以 将 
它们 链接 在 一 起 ， 约 束 之 间 用 冒号 分 隔 ， 如 代码 清 
单 15-29 所 示 。 


代码 清单 15-29 在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 


组 合 内 联 约束 





using 
using 
using 
using 
using 
using 
using 
using 
using 


System; 

System.Collections.Generic; 

System. Ling; 

System. Threading.Tasks; 
Microsoft.AspNetCore. Builder; 
Microsoft.AspNetCore.Hosting; 
Microsoft.AspNetCore.Http; 
Microsoft.Extensions.DependencyInjection; 
Microsoft.AspNetCore.Routing.Constraints; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 


n services) { 


services.AddMvc(); 


public void Configure(IApplicationBuilder app, 


THostingEnvironment env) { 


app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 


app.UseMvc(routes => { 
routes .MapRoute(name: "MyRoute", 
template: "{controller=Home}/{actio 


+ "/{id:alpha:minlength(6)?}"); 





在 以 上 代码 中 ， 已 将 alpha 和 minlength 约 束 应 用 
于 id 厂 段 。 问 号 表示 这 是 一 个 在 所 有 约束 之 后 应 用 
的 可 选 片 段 。 这 些 约束 的 组 合 效 果 是 : 路 由 将 仅 匹 
配 省 略 了 id 卢 段 的 URL 《因为 id 户 段 是 可 选 的 ) ， 
RE Sid RATE AE BOS FEES IN ADL 
AC 





如 果 不 使 用 内 联 约束 ， 则 必须 使 用 
Microsoft.AspNetCore.Routing.CompositeRouteConstr 
类 ， 以 允许 多 个 约束 与 匿名 类 型 对 象 中 的 单个 属性 
相关 联 。 代 码 清单 15-30 显 示 了 在 代码 清单 15-29 中 
使 用 的 组 合约 束 。 








代码 清单 15-30 在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 


using System; 
using System.Collections.Generic; 
using System.Ling; 
using System. Threading. Tasks; 


using Microsoft 
using Microsoft 
using Microsoft 


using Microsoft. 
.AspNetCore 
AspNetCore. 


using Microsoft 


using Microsoft. 


.AspNetCore. 
.AspNetCore. 
.AspNetCore. 
Extensions. 
.Routing.Constraints; 


namespace UrlsAndRoutes { 
public class Startup { 


组 合 单独 的 约束 





Builder; 

Hosting; 

Http; 
DependencyInjection; 


Routing; 


public void ConfigureServices(IServiceCollectio 


n services) { 


services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes.MapRoute(name: "MyRoute", 
template: "{controller}/{action}/{i 


d?}", 


defaults: new { controller = "Home" 
» action = "Index" }, 
constraints: new { 


id = new CompositeRouteConstrai 


new IRouteConstraint[] { 
new AlphaRouteConstrain 


new MinLengthRouteConst 





CompositeRouteConstraint 类 的 构造 函数 接收 实 
现 了 IRouteConstraint 对 象 的 枚 举 ，IRouteConstraint 
对 象 是 定义 路 由 约束 的 接口 。 仅 当 满 足 所 有 约束 
时 ， 路 由 系统 才 人 允许 路 由 匹配 URL。 


15.7.4 定义 自 定 义 约束 


如 采 标 准 约束 无 法 满足 需求 ， 那 么 可 以 通过 实 
Ey Microsoft. AspNetCore.Routing fig 4 T] P E SC AY 
IRouteConstraint 接 口 来 定义 自 定义 约束 。 为 了 演示 
此 功能 ， 在 示例 项 目 中 添加 Infrastructure 文 件 夹 ， 





并 创建 名 为 WeekDayConstraint.cs 的 类 文件 ， 内 容 如 
代码 清单 15-31 所 示 。 


代码 清单 15-31 Infrastructure 文件 夹 下 的 WeekDayConstraint.cs 
文件 的 内 容 


using Microsoft.AspNetCore.Http; 
using Microsoft.AspNetCore. Routing; 
using System.Ling; 


namespace UrlsAndRoutes.Infrastructure { 
public class WeekDayConstraint : IRouteConstraint { 
private static string[] Days = new[] { "mon", " 
tue", "wed", "thu", 
PELS 
sat", "sun" }; 


public bool Match(HttpContext httpContext, IRou 
ter route, 


string routeKey, RouteValueDictionary value 


S, 
RouteDirection routeDirection) { 


return Days.Contains(values[routeKey]?.ToSt 
ring().ToLowerInvariant()); 
} 
} 





IRouteConstraint 接 口 定 义 了 Match 方 法 ， 可 调 


用 该 方法 以 允许 约束 来 决定 请 求 是 否 应 该 与 路 由 罗 
配 。Match 方 法 的 参数 提供 对 多 种 来 源 的 请 求 的 访 
问 ， 包 括 客户 端 、 路 由 、 受 约束 片段 的 名 称 、 从 
URL 提 取 的 片段 变量 以 及 请 求 是 否 检查 传 入 或 传 出 
的 URL 《第 16 草 将 解释 传 出 的 URL ) 。 








在 该 例 中 ， 使 用 routeKey 参 数 从 values 参 数 获 
取 已 应 用 约束 的 片段 变量 的 值 ， 将 它们 转换 为 小 写 
字符 串 ， 并 奉 看 是 人 否 匹配 在 静态 字段 Days 中 定义 的 
一 周 中 的 那 几 天 。 代 码 清 单 15-32 使 用 单独 的 方法 
将 新 约束 应 用 于 示例 路 由 。 











代码 清单 15-32 在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 
应 用 上 自 定 义 约 束 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


using Microsoft.AspNetCore.Routing.Constraints; 
using Microsoft.AspNetCore. Routing; 
using UrlsAndRoutes.Infrastructure; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes .MapRoute(name: "MyRoute", 
template: "{controller}/{action}/{i 
dey", 
defaults: new { controller = "Home" 
» action = "Index" }, 
constraints: new { id = new WeekDay 


Constraint() }); 
})3 





仅 当 id 片段 不 存在 〈 例 如 /CustomervList) 或 者 
与 约束 类 中 定义 的 星期 几 ( 例 





如 /CustomeLisVEFri) 匹配 时 ， 路 由 才 会 匹配 
URL. 





定义 内 联 目 定义 约束 


为 了 设置 自 定义 约束 并 使 其 可 以 内 联 使 用 ， 需 
要 执行 一 个 额外 的 配置 步 又， 如 代码 清单 15-33 所 


代码 清单 15-33 在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 
使 用 内 联 自 定义 约束 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.AspNetCore.Routing.Constraints; 
using Microsoft.AspNetCore. Routing; 

using UrlsAndRoutes.Infrastructure; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.Configure<RouteOptions>(options => 
options.ConstraintMap.Add("weekday", t 
ypeof (WeekDayConstraint) )); 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes.MapRoute(name: "MyRoute", 
template: "{controller=Home}/{action=In 
dex}/{id:weekday?}"); 
})3 





以 上 代码 在 ConfigureService 方 法 中 配置 了 
RouteOptions 对 象 ， 以 控制 路 由 系统 的 一 些 行为 。 
ConstraintMap 属 性 会 返回 一 个 字典 ， 用 于 将 内 联 约 
束 的 名 称 转换 为 提供 约束 逻辑 的 IRouteConstraint 实 
现 关 。 回 字典 添加 一 个 新 的 映射 ， 将 
WeekDayConstraint 类 内 联 引 用 为 weekday， 如 下 所 


2N: 


template: "{controller=Home}/{action=Index}/{id:weekday 
? mm 








约束 的 效 束 是 相同 的 ， 但 设置 了 映射 以 允许 目 
定义 英和 被 内 联 使 用 。 





15.8 使 用 特性 路 由 





到 目前 为 止 ， 本 章 的 所 有 示例 都 是 使 用 一 种 称 
为 “基于 约定 的 路 由 ”的 技术 定义 的 。MVC 还 文 持 称 
为 特性 路 由 的 技术 ， 下 接 使 用 控制 右 关 的 C# 属 性 来 
定义 路 由 。 下 面 将 展示 如 何 使 用 特性 创建 和 配置 路 
由 ， 这 些 特性 可 以 与 前 面 示例 中 的 基于 约定 的 路 由 
目 由 混合 使 用 。 








15.8.1 准备 特性 路 由 


在 Startup.cs 文 件 中 调用 UseMvc 方 法 时 ， 将 启 
用 特性 路 由 。MVC 检 查 应 用 程序 中 的 控制 器 类 ， 便 
找 具 有 特性 路 由 的 任何 控制 句 类 ， 并 为 它们 创建 路 


由 。 





本 节 中 ， 示 例 应 用 程序 已 还 原 到 默认 路 由 配 
置 ， 如 代码 清单 15-34 所 示 。 


代码 清单 15-34 使 用 UrlsAndRoutes 文 件 严 下 的 Startup.cs 文 件 


中 的 默认 路 由 配置 





using 
using 
using 
using 
using 
using 
using 
using 
using 
using 
using 


System; 

System.Collections.Generic; 

System. Ling; 

System. Threading.Tasks; 
Microsoft.AspNetCore. Builder; 
Microsoft.AspNetCore.Hosting; 
Microsoft.AspNetCore.Http; 
Microsoft.Extensions.DependencyInjection; 
Microsoft.AspNetCore.Routing.Constraints; 
Microsoft.AspNetCore. Routing; 
UrlsAndRoutes.Infrastructure; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 


n services) { 
services.Configure<RouteOptions>(options => 
options.ConstraintMap.Add( "weekday", ty 
peof (WeekDayConstraint) ) ) ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 








默认 路 由 将 使 用 以 下 模 陈 匹配 URL: 


{controller}/{action}/{id?} 
15.8.2 ”应 用 特性 路 由 





Route 特性 用 于 指定 单个 控制 器 和 操作 方法 的 
路 由 。 在 代码 清单 15-35 中 ， 已 将 Route 特性 应 用 


+ CustomerController2é . 


代码 清单 15-35 ”在 Controllers 文 件 夹 下 的 CustomerController.cs 


文件 中 应 用 Route 特性 


using Microsoft.AspNetCore.Mvc; 
using UrlsAndRoutes.Models; 


namespace UrlsAndRoutes.Controllers { 
public class CustomerController : Controller { 


[Route("myroute" ) ] 
public ViewResult Index() => View("Result", 
new Result { 
Controller = nameof(CustomerController) 


Action = nameof (Index) 


}); 


public ViewResult List(string id) { 

Result r = new Result { 
Controller = nameof(HomeController), 
Action = nameof(List), 

}; 

r.Data["id"] = id ?? "<no value>"; 

r.Data["catchall"] = RouteData.Values["catc 

hall" ]; 
return View("Result", r); 








Route 特 性 可 用 于 为 操作 方法 或 控制 器 定义 路 
由 。 在 以 上 代码 中 ， 已 将 Route 特性 应 用 于 Index 操 








作 方 法 ， 并 将 myroute 指 定 为 应 该 使 用 的 路 由 。 效 
果 是 更 改 了 用 于 访问 Customer 控 制 器 定义 的 操作 方 
法 的 路 由 集合 ， 如 表 15-9 所 示 。 








#215-9 ”路 由 集合 
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有 了 两 点 需要 注意 。 第 一 点 是 当 使 用 Route 特性 
时 ， 你 提供 的 用 于 配置 特性 的 值 将 用 于 定义 完整 的 
路 由 ， 因 此 myroute 成 为 访问 Index 操 作 方 法 的 完整 
URL。 和 需要 注意 的 第 二 点 是 ， 使 用 Route 特 性 可 以 
防止 使 用 默认 路 由 配置 ， 因 此 无 法 再 使 
用 /Customer/Index URL 访 问 Index 操 作 方 法 。 











1. 更 改 操作 方法 的 名 称 


为 单个 操作 方法 定义 唯一 路 由 在 大 多 数 应 用 程 
序 中 没什么 用 ， 但 Route 特性 也 可 以 更 灵活 地 使 
用 。 代 码 清单 15-36 在 路 由 中 使 用 特殊 的 [controller] 
标记 来 引用 控制 絮 并 设置 路 由 的 基本 部 分 。 








q 
提 示 


使 用 ActionName 属 性 也 可 以 更 改 操 作 的 名 称 ， 
具体 将 在 第 31 章 中 介绍 。 


代码 清单 15-36” 重 命 名 Controllers 文 件 夹 下 的 
CustomerController.cs 文 件 中 的 操作 方法 


using Microsoft.AspNetCore.Mvc; 
using UrlsAndRoutes .Models; 


namespace UrlsAndRoutes.Controllers { 
public class CustomerController : Controller { 


[Route("[controller]/MyAction" ) ] 
public ViewResult Index() => View("Result", 
new Result { 
Controller = nameof(CustomerController) 


Action = nameof (Index) 


}); 


public ViewResult List(string id) { 
Result r = new Result { 
Controller = nameof(HomeController), 
Action = nameof(List), 
}; 
r.Data["id"] = id ?? "<no value>"; 
r.Data["catchall"] = RouteData.Values["catc 


return View("Result", r); 





在 Route 特性 的 参数 中 使 用 [controller] 标 记 就 像 
使 用 nameof 表 达 式 一 样 ， 人 允许 指定 到 控制 器 的 路 
由 ， 而 无 须 对 类 名 进行 硬 编 码 。 表 15-10 描 述 了 代 
人 码 清单 15-36 中 路 由 的 效果 。 


表 15-10 “Customer 控制 器 的 路 由 


/Customer/List 以 List 操 作 方 法 为 目标 
/Customer/MyAction 以 Index 操 作 方 法 为 目标 




















2. 创建 更 复杂 的 路 由 


Route 特性 也 可 以 应 用 于 控制 豆 类 ， 人 允许 定义 
路 由 的 结构 ， 如 代码 清单 15-37 所 示 。 


代码 清单 15-37 ”在 Controllers 文 件 夹 下 的 CustomerController.cs 
文件 中 应 用 Route 特 性 





using Microsoft.AspNetCore.Mvc; 
using UrlsAndRoutes .Models; 


namespace UrlsAndRoutes.Controllers { 


[Route("app/[controller]/actions/[action]/{id?}") ] 
public class CustomerController : Controller { 


public ViewResult Index() => View("Result", 
new Result { 


Controller = nameof(CustomerController) 


Action = nameof(Index) 


}); 


public ViewResult List(string id) { 
Result r = new Result { 
Controller = nameof(HomeController), 
Action = nameof(List), 
}; 
r.Data["id"] = id ?? "<no value>"; 
r.Data["catchall"] = RouteData.Values["catc 


return View("Result", r); 





DA ER YEG BEA SAS Hr BAe ee Be, IF 
使 用 [controller] 和 [action] 标 记 来 分 别 引 用 控制 器 类 
的 名 称 和 操作 方法 。 表 15-11 显 示 了 代码 清单 15-37 
中 路 由 的 效果 。 








表 15-11 代码 清单 15-37 中 路 由 的 效果 









































路 
app/customer/actions/index 以 Index 操作 方法 为 目标 


app/customer/actions/index/myid | 以 Index 操 作 方 法 为 目标 ， 并 将 可 选 的 id 片段 设置 为 myid 











app/customer/actions/list 以 List 操 作 方 法 为 目标 





app/customer/actions/list/myid 以 List 操 作 方 法 为 目标 ， 并 将 可 选 的 id 片段 设置 为 myid 








15.8.3 ”应 用 路 由 约束 


使 用 特性 定义 的 路 由 可 以 像 Startup.cs 文 件 中 定 
义 的 路 由 那样 ， 使 用 与 基于 约定 的 路 由 相同 的 内 联 
技术 进行 约束 。 在 代码 清单 15-38 中 ， 已 将 本 章 前 
面 创建 的 目 定义 约束 应 用 于 Route 特 性 定义 的 可 选 id 
Fr Ez. 








代码 清单 15-38 在 Controllers 文 件 夹 下 的 CustomerController.cs 
文件 中 约束 路 由 





using Microsoft.AspNetCore.Mvc; 
using UrlsAndRoutes .Models; 


namespace UrlsAndRoutes.Controllers { 


[Route("app/[ controller ]/actions/[action]/{id:weekd 
ay?}")] 


public class CustomerController : Controller { 


public ViewResult Index() => View("Result", 
new Result { 
Controller = nameof(CustomerController ) 


Action = nameof(Index) 


}); 


public ViewResult List(string id) { 
Result r = new Result { 
Controller = nameof(HomeController), 
Action = nameof(List), 
}; 
r.Data["id"] = id ?? "<no value>"; 
r.Data["catchall"] = RouteData.Values[ "catc 


return View("Result", r); 





可 以 使 用 表 15-8 中 描述 的 所 有 约束 ， 也 可 如 代 
码 所 示 ， 使 用 已 在 RouteOptions 服 务 中 注册 的 自 定 
义 约束 。 可 以 通过 将 它们 链接 在 一 起 并 用 冒号 分 隔 
它们 来 应 用 多 个 约束 。 





15.9 小结 


本 章 深 入 介绍 了 路 由 系统 。 你 已 经 了 解 了 按 约 
定 或 特性 定义 路 由 的 方式 。 你 还 了 解 了 如 何 匹 配 和 
处 理 传 入 的 URL， 以 及 如 何 通 过 更 改 匹 配 UREL 片 段 
的 方式 和 使 用 默认 值 及 可 选 片 段 来 自 定 义 路 由 。 这 
里 还 展示 了 如 何 使 用 内 置 约束 和 上 自 定义 约束 ， 用 来 
约束 路 由 以 缩小 它们 匹配 的 请 求 范围 。 


下 一 章 将 展示 如 何 通 过 路 由 在 视图 中 生成 传 出 
的 URL， 以 及 如 何 使 用 area 特 性 ， 它 依赖 路 由 系 
统 ， 可 以 用 于 管理 大 型 的 和 复杂 的 MVC 应 用 程序 。 








第 16 章 ”高 级 路 由 特性 


上 一 和 草 展 示 了 如 何 使 用 路 由 系统 来 处 理 传 入 的 
URL， 我 们 还 需要 能 够 使 用 URL 模 陈 来 生成 可 以 签 
入 视图 中 的 得 出 URL， 以 便 用 户 可 以 单 击 链接 ， 以 
正确 的 控制 占 和 action 为 目标 ， 将 表单 回 媚 给 应 用 
程序 。 





本 章 将 展示 生成 输出 URL 的 不 同 技 术 ， 展 示 如 
何 通 过 蔡 换 标准 的 MVC 路 由 实现 类 来 定制 路 由 系统 
以 及 使 用 MVC 区 域 (area) 特性 ，area 特 性 让 你 能 
够 将 大 型 的 复杂 MVC 应 用 程序 分 解 为 奉 干 可 管理 的 
小 型 区 域 。 最 后 ， 以 一 些 有 关 MVC 应 用 程序 中 URL 
模式 最 佳 实践 的 建议 结束 本 草 ， 表 16-1 汇 总 了 在 上 
下 文中 使 用 高 级 路 由 特性 时 的 一 些 问题 。 





表 16-1 在 上 下 文中 使 用 高 级 路 由 特性 





路 由 系统 除了 为 HTTP 请 求 丐 配 URL 外 ， 还 提供 了 很 多 功能 ， 
E， 在 应 用 程序 中 构建 相互 隔离 的 























生成 URL， 使 月 





模块 ， 
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昌 自 定义 类 替换 内 置 的 路 由 功 色 
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的 每 个 功能 在 
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系统 ， 更 容易 地 利 月 





自 的 应 用 场景 中 都 是 很 有 用 的 ， 比 妇 
式 ， 我 们 不 用 更 新 视图 ， 就 可 以 很 容易 地 更 改 URL 的 格式 ， 使 用 自 定义 类 可 以 
让 我 们 根据 需要 定制 路 | 





比如 支持 在 视图 中 





[通过 设置 路 由 格 





应 用 程序 构建 复杂 的 系统 





有 关 路 由 使 用 的 详细 信息 ， 请 参阅 本 章 






































程序 的 路 由 配置 可 能 变 得 难以 管理 




















没有 ， 路 由 系统 是 ASP.NET 的 组 成 部 分 之 一 





表 16-2 列 出 了 本 章 要 介绍 的 操作 。 


表 16-2 本章 要 介绍 的 操作 





操作 


方法 


代码 清单 




















代码 清单 16-2 一 代码 清单 
16-5 





























使 用 URL 生 成 锚 点 元 素 jasp-action 和 asp-controller 属 性 











代码 清单 16-6 和 代码 清单 
16-7 
































是 供 路 由 片段 的 值 以 asp-route 为 前 绥 的 属性 


























T 、 用 asp-procotol、asp-host 和 asp- eer 
生成 完全 限定 的 URL 代码 清单 16-8 
fragment 属 性 























代码 清单 16-9 和 代码 清单 
16-10 

















选择 生成 URL 的 路 由 jasp-route 属 性 











生成 没有 HTML 元 素 的 在 视图 或 操作 方法 中 使 用 Un.Action | 代码 清单 16-11 和 代码 清 
URL 方法 单 16-12 























代码 清单 16-13 














代码 清单 16-14 一 代码 ; 
单 16-21 






































代码 清单 16-22 一 代码 ; 
单 16-28 
























































16.1 准备 示例 项 目 


本 章 继续 使 用 前 一 章 的 UrlsAndRoutes 项 目 ， 但 


是 在 Startup 类 中 进行 一 些 修改 。 在 Startup 类 中 ， 使 
用 具有 相同 效 末 的 显 式 路 由 和 蔡 换 
UseMvcWithDefaultRoute 方 法 ， 如 代码 清单 16-1 所 





人 小。 


代码 清单 16-1 修改 UrlsAndRoutes 文 件 夹 下 的 Startup 类 中 的 路 
由 配置 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.AspNetCore.Routing.Constraints; 
using Microsoft.AspNetCore. Routing; 

using UrlsAndRoutes.Infrastructure; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.Configure<RouteOptions>(options => 
options.ConstraintMap.Add("weekday", ty 
peof (WeekDayConstraint) ) ) ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc (routes => { 
routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 


n=Index}/{id?}"); 
}); 





当局 动 程序 时 ， 浏 览 右 会 请 求 默认 的 URL， 请 
求 会 被 发 送 给 Home 控 制 的 mdex 操 作 方 法 ， 如 网 16- 
1 所 示 。 





图 16-1 ”运行 示例 应 用 程序 


16.2 在 视图 中 生成 传 出 的 URL 


在 几乎 每 个 MVC 应 用 程序 中 ， 都 希望 用 户 可 
以 从 一 个 视图 跳 转 到 另 一 个 视图 ， 这 通常 依赖 于 在 
第 一 个 视图 中 包含 一 个 针对 生成 第 二 个 视图 的 操作 
方法 的 链接 。 方 法 是 在 页 面 中 添加 一 个 静态 元 素 
( 称 为 销 点 元 素 ) ， 用 href 属 性 定位 到 操作 方法 ， 
如 下 所 示 : 


<a href="/Home/CustomVariable">This is an outgoing URL< 
/a> 


如 果 应 用 程序 使 用 默认 的 路 由 配置 ， 这 个 
HTML 元 素 将 创建 一 个 链接 ， 指 向 Home 控 制 器 中 名 
为 CustomVariable 的 操作 方法 。 但 是 这 样 手动 生成 
URL 是 非常 危险 的 ， 当 更 改 应 用 程序 的 URL 格 式 
时 ， 必 须 查 看 所 有 视图 来 更 新 所 有 指 问 控制 器 和 操 
作 方 法 的 链接 ， 这 将 是 一 个 非常 元 长 乏味 且 容 易 出 
错 的 过 程 ， 还 难以 测试 。 所 以 ， 更 好 的 选择 是 使 用 
路 由 系统 来 生成 传 出 的 URL， 这 样 可 以 确保 使 用 程 




















序 的 URL 格 式 来 动态 生成 URL， 并 且 还 能 在 一 定 程 
度 上 反映 程序 的 URL 格 去。 


16.2.1 创建 传 出 的 链接 





在 视图 中 生成 传 出 的 URE 的 最 简单 方法 是 使 用 
划 标 签 助手 ， 它 将 为 HTML 元 素 生 成 href 属 性 ， 如 
代码 清单 16-2 所 示 ， 可 在 视 
图 /Views/Shared/Result.cshtml 中 使 用 锚 标 签 助 手 来 
创建 传 出 的 链接 。 





二 


fe ” 示 


第 23 章 将 解释 标签 助手 的 工作 原理 。 


代码 清单 16-2 ”在 Views/Shared 文 件 夹 下 的 Result.cshtml 文 件 中 
使 用 销 标 签 助手 


@model Result 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Routing</title> 
<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 
<table class="table table-bordered table-striped ta 
ble-sm"> 
<tr><th>Controller:</th><td>@Model.Controller</ 
td></tr> 
<tr><th>Action:</th><td>@Model .Action</td></tr> 
@foreach (string key in Model.Data.Keys) { 
<tr><th>@key :</th><td>@Model .Data[ key ]</td 
></tr> 
} 
</table> 
<a asp-action="CustomVariable">This is an outgoing 
URL</a> 
</body> 
</html> 





asp-action 属 性 用 来 指定 href 属 性 中 的 URL 指 回 
的 对 应 名 称 的 操作 方法 。 可 以 通过 局 动 应 用 程序 来 
得 看 结果 ， 如 网 16-2 所 示 。 





图 16-2 ”使 用 标签 助手 来 生成 链接 





标签 助手 使 用 当前 路 由 配置 在 a 元 系 上 设置 href 
属性 。 如 末 但 看 浏览 占 中 的 HTML 标 记 ， 你 会 看 到 
其 中 包含 以 下 元 系 : 


<a href="/Home/CustomVariable">This is an outgoing URL< 
/a> 


这 个 链接 看 起 来 和 之 前 手动 编写 的 链接 是 一 样 
的 ， 而 且 为 了 生成 这 个 链接 ， 我 们 还 做 了 很 多 其 他 
的 工作 。 但 是 这 种 方法 的 好 处 是 链接 会 目 动 啊 应 路 
由 配置 的 更 改 。 为 了 演示 ， 在 Startup.cs 文 件 中 添加 











一 个 新 的 路 由 配置 ， 如 代码 清单 16-3 所 示 。 





代码 清单 16-3 ”在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 添 
加 路 由 配置 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading.Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.AspNetCore.Routing.Constraints; 
using Microsoft.AspNetCore. Routing; 

using UrlsAndRoutes.Infrastructure; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.Configure<RouteOptions>(options => 
options.ConstraintMap.Add( "weekday", ty 
peof (WeekDayConstraint) ) ) ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 


app.UseStaticFiles(); 
app.UseMvc(routes => { 


routes .MapRoute( 
name: "NewRoute", 
template: "App/Do{action}", 
defaults: new { controller = "Home" 


}); 


routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 


n=Index}/{id?}"); 


3 





新 路 由 更 改 了 针对 Home 控 制 器 的 请 求 的 URL 
模式 。 如 果 局 动 应 用 ， 你 将 看 到 这 些 更 改 会 反映 在 
由 HTML 辅 助 方法 ActionLink 生 成 的 HTML 标 记 中 ， 
如 下 所 示 : 


<a href="/App/DoCustomVariable">This is an outgoing URL 
</a> 


AE FD oy ee BU E NE ec) fE R ES EY ES TH] 
题 。 当 更 改 路 由 格式 时 ， 视 图 中 的 传 出 链接 会 目 动 





根据 路 由 格式 更 改 ， 无 须 在 视图 中 手动 编辑 。 


当 单 击 链接 时 ， 传 出 的 URL 用 于 创建 传 入 的 
HTTP 请 求 ， 然 后 使 用 相同 的 路 由 来 定位 将 用 于 处 
理 请 求 的 控制 占 和 操作 方法 ， 如 图 16-3 所 示 。 





图 16-3 单 击 链 接 ， 将 传 出 的 URL 转 换 为 传 入 的 请 求 


理解 传 出 的 URL 的 路 由 匹配 








你 已 经 看 到 了 通过 更 改 路 由 配置 的 URL 模 式 ， 
可 以 修改 传 出 的 URL 的 生成 方式 。 应 用 程序 通常 会 
定义 多 个 路 由 ， 所 以 了 解 如 何 为 URL 的 生成 选择 路 
由 规则 很 重要 。 路 由 系统 按照 定义 的 顺序 处 理 路 





由 ， 依 次 检查 每 个 路 由 ， 查 看 是 否 匹 配 ， 这 需要 满 
足以 下 3 个 条 件 。 


。URL 模 式 中 定义 的 每 个 片段 变量 都 必须 有 一 个 
值 。 为 了 得 找 每 个 片段 变量 的 值 ， 路 由 系统 首 
移 得 看 你 提供 的 值 〈 使 用 匿名 类 型 的 属性 ) ， 
然后 查看 当前 请 求 的 变量 值 ， 最 后 查看 路 由 中 
定义 的 默认 值 〈( 本 章 称 后 再 回 到 这 些 值 的 第 二 
个 来 源 ) 。 

为 片段 变量 提供 的 任何 值 都 不 会 与 路 由 中 定义 
的 默认 变量 发 生 不 一 致 。 这 些 是 已 经 提供 了 默 
认 值 但 在 URL 模 式 中 不 会 出 现 的 变量 。 例 如 ， 
在 下 面 的 路 由 定义 中 ，myVar 是 默认 变量 。 








routes .MapRoute("MyRoute", "{controller}/{action}" 


new { myVar = "true" }); 





为 了 使 以 上 路 由 匹配 ， 必 须 注意 不 要 
为 myVar 提 供 值 ， 或 者 确保 提供 的 值 与 默认 值 匹 
配 。 








。 所 有 片段 变量 的 值 必须 满足 路 由 约束 。 有 关 不 
同 种 类 约束 的 示例 ， 请 参阅 15.6 节 。 





需要 明确 的 是 ， 路 由 系统 不 会 尝试 选取 最 佳 的 
路 由 规则 来 进行 匹配 ， 而 只 是 寻找 第 一 个 可 以 匹配 
的 规则 ， 并 根据 该 规则 生成 URL， 任 何 后 续 的 路 由 
规则 都 会 被 忽略 。 因 此 ， 必 须 首 移 定 义 那 些 特 殊 的 
路 由 规则 ， 检 和 碍 生成 的 传 出 URL 也 很 重要 。 如 宋 答 
试 生成 找 不 到 匹配 路 由 的 URL， 将 创建 如 下 包含 空 
的 href 属 性 的 链接 : 


<a href="">This is an outgoing URL</a> 


以 上 链接 将 正确 显示 在 视图 中 ， 但 在 用 户 单 击 
时 不 会 按 预期 方式 运行 。 如 果 只 生成 URL (AHA 
后 会 展示 如 何 实现 ) ， 那 么 结果 将 为 null， 在 视图 
中 作为 空 字 符 串 呈现 。 可 以 使 用 命名 路 由 对 路 由 匹 
配 进行 一 些 控 制 。 














1. 定位 其 他 控制 器 





当 在 一 个 元 素 上 指定 asp-action 属 性 时 ， 标 签 助 
手 会 在 泻 染 视 图 时 假定 你 要 定位 到 同一 控制 桌 中 的 
action。 要 创建 以 不 同 控 制 器 为 目标 的 传 出 URL， 
可 以 使 用 asp-controller 属 性 ， 如 代码 清单 16-4 所 
ZN o 








代码 清单 16-4 在 Views/Shared 文 件 严 下 的 Resultcshtml 文 件 中 
EDLA E RIFE I AF 








@model Result 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Routing</title> 
<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 


<table class="table table-bordered table-striped ta 
ble-sm"> 
<tr><th>Controller:</th><td>@Model.Controller</ 
td></tr> 
<tr><th>Action:</th><td>@Model .Action</td></tr> 
@foreach (string key in Model.Data.Keys) { 
<tr><th>@key :</th><td>@Model .Data[ key ]</td 
></tr> 
} 
</table> 
<a asp-controller="Admin" asp-action="Index"> 
This targets another controller 
</a> 
</body> 
</html> 





在 演 染 视图 时 ， 你 将 看 到 生成 了 以 下 HTML 标 
id: 

指向 Admin 控 制 器 中 Index 操 作 方 法 的 请 求 URL 
被 标签 助手 表示 为 /Admin。 路 由 系统 知道 应 用 程序 


中 定义 的 路 由 默认 使 用 Index 操 作 方法 ， 因 而 允许 忽 
略 不 必要 的 卢 段 变量 。 








路 由 系统 包含 那些 使 用 Route 特性 给 操作 方法 
指定 路 由 规则 的 路 由 。 在 代码 清单 16-5 中 ，asp- 
controller 属 性 用 于 定位 在 第 15 章 中 使 用 了 Route 特性 
HJ Customer 4 til] ai Fl Index #21 F 77 YIA « 








代码 清单 16-5 ”在 Views/Shared 文 件 严 下 的 Result.cshtml 文 件 中 
定位 操作 方法 





@model Result 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Routing</title> 
<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="panel-body"> 
<table class="table table-bordered table-striped ta 
ble-sm"> 
<tr><th>Controller:</th><td>@Model.Controller</ 
td></tr> 
<tr><th>Action:</th><td>@Model .Action</td></tr> 
@foreach (string key in Model.Data.Keys) { 
<tr><th>@key :</th><td>@Model .Data[ key ]</td 
></tr> 


} 
</table> 
<a asp-controller="Customer" asp-action="Index">Thi 
s is an outgoing URL</a> 
</body> 
</html> 





生成 的 链接 如 下 : 


<a href="/app/Customer/actions/Index">This is an outgoi 
ng URL</a> 


这 对 应 于 第 15 章 中 为 Customer 控 制 器 设置 的 


Route 特 性 : 


[Route("app/[controller]/actions/[action]/{id:weekday?} 
")] 


public class CustomerController : Controller { 





2. 传递 额外 的 变量 值 





可 以 使 用 asp-route- 卢 段 变 量 名 格式 将 片段 变量 
的 值 传递 给 路 由 系统 ， 比 如 可 以 使 用 asp-route-id 将 


值 传 给 路 由 系统 中 的 id， 如 代码 清单 16-6 所 示 。 


代码 清单 16-6 ”为 Views/Shared 文 件 夹 下 的 Result.cshtml 文 件 中 
的 片段 变量 提供 值 





@model Result 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Routing</title> 
<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 
<table class="table table-bordered table-striped ta 
ble-sm"> 
<tr><th>Controller:</th><td>@Model.Controller</ 
td></tr> 
<tr><th>Action:</th><td>@Model .Action</td></tr> 
@foreach (string key in Model.Data.Keys) { 
<tr><th>@key :</th><td>@Model .Data[ key ]</td 
></tr> 
} 
</table> 
<a asp-controller="Home" asp-action="Index" asp-rou 
te-id="Hello"> 
This is an outgoing URL 
</a> 


</body> 
</html> 
这 里 为 名 为 id 的 厂 段 变量 设置 了 值 ， 如 果 应 用 


代码 清单 16-6 所 示 的 路 由 ， 在 视图 泻 染 的 时 候 将 会 
呈现 以 下 HTML 标记: 














<a href="/App/DoIndex?id=Hello">This is an outgoing URL 





</a> 


请 注意 ， 片 段 变量 的 值 已 经 根据 路 由 规则 做 了 
设置 ， 成 为 URL 中 会 询 字 符 串 的 一 部 分 。 路 由 中 没 
有 设置 对 应 于 id 的 厂 段 变量 ， 为 了 解决 这 个 问题 ， 
修改 Startup.cs 文 件 中 的 路 由 ， 只 留 下 一 个 拥有 id 片 
段 变 量 的 路 由 ， 如 代码 清单 16-7 所 示 。 








代码 清单 16-7 在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 修 
改 路 由 





using System; 

using System.Collections.Generic; 
using System.Ling; 

using System. Threading. Tasks; 


using Microsoft.AspNetCore.Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.AspNetCore.Routing.Constraints; 
using Microsoft.AspNetCore. Routing; 

using UrlsAndRoutes.Infrastructure; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.Configure<RouteOptions>(options => 
options.ConstraintMap.Add( "weekday", ty 
peof (WeekDayConstraint) ) ) ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 


//routes .MapRoute( 

// name: "NewRoute", 

// template: "App/Dof{action}", 

// defaults: new { controller = "Hom 


e" }); 


routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 
n=Index}/{id?}"); 


再 次 运行 应 用 ， 你 将 看 到 标签 助手 生成 的 URL 
中 已 经 包含 了 id 属 性 的 值 。 


<a href="/Home/Index/Hello">This is an outgoing URL</a> 





理解 片段 变量 的 重用 


之 前 在 描述 匹配 的 路 由 传 出 URL 的 方式 时 ， 本 
书 解释 说 ， 当 试图 为 路 由 的 URL 模 式 中 的 每 个 片段 
变量 查找 值 时 ， 路 由 系统 将 查看 当前 请 求 的 值 。 这 
种 方式 可 能 会 困扰 很 多 程序 员 ， 并 且 导 致 兄 长 的 调 
试 会 话 。 

















假设 应 用 程序 有 如 下 路 由 : 


app.UseMvc(routes => { 
routes .MapRoute(name: "MyRoute", 


template: "{controller}/{action}/{color}/{page} 





假设 我 们 所 在 的 页 面 URL 
为 /Home/Index/Red/100， 在 页 面 中 利用 以 下 代码 泻 
RTE Hae 


<a asp-controller="Home" asp-action="Index" asp-route-p 
age="789"> 

This is an outgoing URL 
</a> 





你 可 能 期 望 路 由 系统 无 法 匹配 路 由 ， 因 为 没有 
为 color 厂 段 变 量 提供 值 ， 也 没有 定义 默认 值 。 期 望 
是 错误 的 ， 路 由 系统 将 与 定义 的 路 由 匹配 ， 还 将 生 
成 以 下 HTML 标 记 : 











<a href="/Home/Index/Red/789">This is an outgoing URL</ 


路 由 系统 热衷 于 对 路 由 进行 匹配 ， 在 生成 传 出 
的 URL 时 ， 将 在 传 入 的 URL 中 重用 片段 变量 的 值 。 


在 这 种 情况 下 ， 根 据 页 面 使 用 的 URL， 路 由 系统 将 
设置 color 变 量 的 值 为 Red。 











这 并 不 是 最 后 的 手段 。 路 由 系统 将 应 用 此 技术 
作为 对 路 由 的 常规 评估 的 一 部 分 ， 即 使 后 面 的 路 由 
个 需要 重用 当前 请 求 中 的 值 ， 也 会 进行 匹配 。 








强烈 建议 你 不 要 依赖 此 行为 ， 并 为 URL 模 式 中 
的 所 有 片段 变量 提供 值 。 依 赖 这 种 行为 不 仅 会 使 代 
人 码 更 难 阅读 ， 而 且 还 会 对 用 户 发 出 请 求 的 顺序 做 出 
假设 ， 这 将 在 应 用 程序 进入 维护 时 令 人 抓 狂 。 





3. 生成 完全 限定 的 URL 





到 目前 为 止 ， 生 成 的 所 有 链接 都 包含 相对 
URL， 但 是 销 标 签 助 手 也 可 以 生成 完全 限定 的 
URL， 如 代码 清单 16-8 所 示 。 


代码 清单 16-8 ”在 Views/Shared 文 件 夹 下 的 Result.cshtml 文 件 中 
生成 完全 限定 的 URL 





@model Result 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Routing</title> 
<link rel="stylesheet" asp-href-include="1ib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 
<table class="table table-bordered table-striped ta 
ble-sm"> 
<tr><th>Controller:</th><td>@Model.Controller</ 
td></tr> 
<tr><th>Action:</th><td>@Model .Action</td></tr> 
@foreach (string key in Model.Data.Keys) { 
<tr><th>@key :</th><td>@Model .Data[ key ]</td 
></tr> 


} 
</table> 


<a asp-controller="Home" asp-action="Index" asp-rou 
te-id="Hello" 


asp-protocol="https" asp-host="myserver.mydomain 


. com" 
asp-fragment="myFragment"> 
This is an outgoing URL 
</a> 
</body> 
</html> 





asp-protocol、asp-host 与 asp-fragment 属 性 分 别 
用 于 指定 协议 (https，、 服 务 絮 名 称 (myserver. 
mydomain.com) 和 URE 片 段 (myFragment) 。 将 
这 些 值 与 路 由 系统 的 输出 相 结 合 ， 即 可 创建 完全 限 





定 的 URL， 可 以 运行 应 用 以 伍 看 发 送 到 浏 贤 绅 的 
HTML: 


<a href="https://myserver.mydomain.com/Home/Index/Hello 
#myFragment"> 


This is an outgoing URL 
</a> 





使 用 完全 限定 的 URL 时 要 小 心 ， 因 为 它们 创建 
了 与 应 用 程序 基础 架构 的 依赖 关系 ， 并 且 基 础 架构 


发 生变 化 时 ， 必 须 记 住 对 MVC 视 图 进行 相应 的 更 
改 。 


4. 从 特定 路 由 生成 URL 


在 前 面 的 示例 中 ， 我 们 演示 了 路 由 系统 如 何 选 
择 路 由 来 生成 URL。 当 需要 和 后 成 特定 格式 的 URL 
时 ， 可 以 指定 用 于 生成 URL 的 路 由 。 为 了 演示 这 是 
如 何 工 作 的 ， 这 里 向 Startup.cs 文 件 添加 一 个 新 的 路 
由 ， 这 时 在 示例 应 用 程序 中 有 两 个 路 由 ， 如 代码 清 
单 16-9 所 示 。 





代码 清单 16-9 ”在 UrlsAndRoutes 文 件 夹 的 Startup.cs 文 件 中 添加 
路 由 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading.Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


using Microsoft.AspNetCore.Routing.Constraints; 
using Microsoft.AspNetCore. Routing; 
using UrlsAndRoutes.Infrastructure; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.Configure<RouteOptions>(options => 
options.ConstraintMap.Add("weekday", ty 
peof (WeekDayConstraint) ) ) ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 


//routes.MapRoute( 


// name: "NewRoute", 
// template: "App/Do{action}", 
// defaults: new { controller = "Hom 


e" }); 


routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 
n=Index}/{id?}"); 


routes .MapRoute( 
name: "out", 
template: "outbound/{controller=Hom 


e}/{action=Index}") ; 
}); 





代码 清单 16-10 所 示 的 视图 中 包含 两 个 锁 元 
素 ， 每 个 部 指定 了 相同 的 控制 费 和 操作 。 不 同 之 处 
在 于 第 二 个 元 素 使 用 asp-route 属 性 来 指定 使 用 的 路 
由 。 





代码 清单 16-10 ”在 Views/Shared 文 件 夹 下 的 Result.Cshtml 文 件 
中 生成 URL 





@model Result 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 

<meta name="viewport" content="width=device-width" 
/> 

<title>Routing</title> 

<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 

<table class="table table-bordered table-striped ta 
ble-sm"> 


<tr><th>Controller:</th><td>@Model.Controller</ 
td></tr> 
<tr><th>Action:</th><td>@Model .Action</td></tr> 
@foreach (string key in Model.Data.Keys) { 
<tr><th>@key :</th><td>@Model .Data[ key ]</td 
></tr> 


} 
</table> 
<a asp-controller="Home" asp-action="CustomVariable 
">This is an outgoing URL</a> 
<a asp-route="out">This is an outgoing URL</a> 
</body> 
</html> 





只 有 在 asp-controller 属 性 和 asp-action 属 性 不 存 

在 时 ， 才 可 以 使 用 asp-route 属 性 ， 这 意味 着 只 能 为 

泻 染 视图 的 控制 絮 和 操作 选择 特定 的 路 由 。 如 果 运 

行 示例 程序 并 请 求 URL /Home/CustomVariable， 你 
将 看 到 路 由 会 生成 两 个 不 同 的 URL: 








<a href="/Home/CustomVariable">This is an outgoing URL< 
/a> 


<a href="/outbound">This is an outgoing URL</a> 





针对 命名 路 由 的 情况 


依靠 路 由 名 称 生 成 传 出 URL 的 问题 在 于 ， 这 样 
做 会 破坏 对 MVC 设 计 模 式 至 关 重 要 的 关注 点 分 离 原 
则 。 在 视图 或 操作 方法 中 生成 链接 或 URL 时 ， 需 要 
关注 用 户 将 被 引导 到 的 操作 和 控制 器 ， 而 不 是 要 使 
用 的 URL 格 式 。 通 过 将 不 同 路 由 引入 视图 或 控制 
器 ， 可 以 避免 创建 依赖 关系 。 在 作者 自己 的 项 目 
中 ， 作 者 倾 问 于 避免 命名 路 由 《通过 为 name 人 参数 指 
定 null) ， 并 且 更 喜欢 使 用 代码 注释 来 提醒 自己 每 
个 路 由 的 目的 。 














16.2.2 ”创建 非 链 接 的 URL 


标签 助手 的 限制 是 ， 对 于 转换 的 HTML 元 素 ， 
当 需 要 为 应 用 程序 生成 URL 而 不想 使 用 周围 的 
HTML 时 ， 无 法 轻易 地 重用 。 


MVC 提 供 了 一 个 辅助 类 ， 可 以 直接 使 用 
Url.Action 方 法 创建 URL， 如 代码 清单 16-11 所 示 。 


代码 清单 16-11 在 Views/Shared 文 件 夹 下 的 Result.cshtml 文 件 
中 生成 URL 





@model Result 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Routing</title> 
<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 
<table class="table table-bordered table-striped ta 
ble-sm"> 
<tr><th>Controller:</th><td>@Model.Controller</ 
td></tr> 
<tr><th>Action:</th><td>@Model .Action</td></tr> 
@foreach (string key in Model.Data.Keys) { 
<tr><th>@key :</th><td>@Model .Data[ key ]</td 
></tr> 
} 
</table> 
<p>URL: @Url.Action("CustomVariable", "Home", new { 
id = 100 })</p> 


</html> 
以 上 代码 在 Url.Action 方 法 的 参数 中 指定 了 操 


ETIE BiAA REEE, ERAR aN 
F: 


<p>URL: /Home/CustomVariable/100</p> 


在 操作 方法 中 生成 URL 











Url.Action 方 法 也 可 以 用 于 在 操作 方法 中 使 用 
C# 代 码 来 创建 URL。 代 码 清单 16-12 修 改 了 Home 控 
制 右 的 一 个 操作 方法 ， 并 使 用 Url.Action 生 成 了 一 
个 URL。 


代码 清单 16-12 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 里 的 操作 方法 中 生成 URL 








using Microsoft.AspNetCore.Mvc; 
using UrlsAndRoutes .Models; 


namespace UrlsAndRoutes.Controllers { 


public class HomeController : Controller { 
public ViewResult Index() => View("Result", 
new Result { 
Controller = nameof(HomeController), 
Action = nameof( Index) 


}); 


public ViewResult CustomVariable(string id) { 
Result r = new Result { 
Controller = nameof(HomeController), 
Action = nameof(CustomVariable), 


}; 

r.Data["Id"] = id ?? "<no value>"; 

r.Data["Ur1l"] = Url.Action("CustomVariable" 
» "Home", new { id = 100 }); 

return View("Result", r); 





如 果 运 行 示例 程序 并 且 请 求 URL 
/Home/CustomVariable/100， 你 将 看 到 表格 中 有 一 
行 显示 了 这 个 URL， 如 图 16-4 所 示 。 











URL: /Home/CustomVariable/100 





图 16-4 在 操作 方法 中 生成 URL 


16.3 目 定 义 路 由 系统 


你 已 经 看 到 了 路 由 系统 的 灵活 性 和 可 配置 性 ， 
如 果 这 些 还 不 符合 要 求 ， 你 也 可 以 目 定 义 行 为 。 本 
节 将 展示 集中 不 同 的 目 定义 路 由 的 方法 。 


16.3.1 更 改 路 由 系统 配置 


第 15 章 展示 了 如 何在 Startup.cs 文 件 中 配置 
RouteOptions 对 象 以 设置 自 定 义 路 由 约束 。 使 用 
RouteOptions 对 象 的 属性 〈( 见 表 16-3) ， 配 置 一 些 
路 由 功能 。 


表 16-3 RouteOptions 对 象 的 属性 


属性 
AppendTrailingSlash | 当 为 tue 时 ， 为 路 | 




















当 为 true 时 ， 如 果 控 和 





LowercaseUrls 

































































URL 转 换 为 小 写 ， 默 认 值 为 false 





代码 清单 16-13 同 Startup.cs 文 件 添 加 了 路 由 配 


置 ， 以 设置 表 16-3 中 描述 


的 两 个 配置 属性 。 


代码 清单 16-13 在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 


配置 路 由 系统 





using System; 
using System.Collections.Generic; 
using System.Ling; 
using System. Threading. Tasks; 


using Microsoft.AspNetCore. 
using Microsoft.AspNetCore. 
using Microsoft.AspNetCore. 
using Microsoft.Extensions. 
using Microsoft.AspNetCore. 
using Microsoft.AspNetCore. 


Builder; 

Hosting; 

Http; 
DependencyInjection; 
Routing.Constraints; 
Routing; 


using UrlsAndRoutes.Infrastructure; 


namespace UrlsAndRoutes { 


public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.Configure<RouteOptions>(options => 
{ 
options.ConstraintMap.Add("weekday", ty 
peof (WeekDayConstraint) ) ; 
options.LowercaseUrls = true; 
options.AppendTrailingSlash = true; 


}); 


services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 


routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 
n=Index}/{id?}"); 


routes .MapRoute( 


name: "out", 
template: "“outbound/{controller=Hom 
e}/{action=Index}") ; 
})3 





如 果 运 行 应 用 并 检查 路 由 系统 生成 的 URL， 你 
将 看 到 URL 全 部 为 小 写 ， 并 且 附 加 了 尾部 和 斜 杜 ， 如 


图 16-5 所 示 。 





图 16-5 ”配置 路 由 系统 


16.3.2 ”创建 目 定义 路 由 类 


如 宋 不 喜欢 路 由 系统 匹配 UREL 的 方式 ， 或 者 需 
要 在 应 用 中 进行 一 些 特 殊 的 实现 ， 可 以 创建 目 己 的 
路 由 类 并 使 用 它们 来 处 理 URL。ASP.NET 提 供 了 
Microsoft.AspNetCore.Routing.IRouter 接 口 ， 可 以 通 
过 实现 此 接口 来 创建 自 定义 路 由 。 以 下 是 IRouter 接 
HAY xe Ms 





using System.Threading.TasKs ; 
namespace Microsoft.AspNetCore.Routing { 
public interface IRouter { 


Task RouteAsync(RouteContext context) ; 


VirtualPathData GetVirtualPath(VirtualPathConte 
xt context); 


} 


} 





要 创建 目 定 义 路 由 ， 可 以 实现 RouteAsync 方 法 
来 处 理 传 入 的 请 求 ， 并 通过 实现 GetVirtualPath 方 法 
来 生成 传 出 的 URL。 


为 了 演示 ， 我 们 将 创建 一 个 可 以 处 理 传 统 URL 
请 求 的 日 定义 路 由 类 。 想 象 一 下 ， 这 里 已 经 将 一 个 
现 有 的 应 用 程序 迁移 到 MVC， 但 是 有 些 用 户 已 经 将 
之 前 的 网 址 加 入 书签 ， 或 者 硬 编码 到 脚本 中 。 为 了 
仍然 支持 那些 旧 的 URL， 可 以 使 用 常规 路 由 系统 ， 
但 是 这 个 问题 的 解决 方法 值得 参考 。 








1. 路 由 传 入 的 URL 


要 了 解 目 定义 路 由 如 何 工 作 ， 可 以 首先 创建 一 
个 路 由 来 处 理 请 求 ， 而 不 使 用 控制 器 和 视图 。 在 
Infrastructure 文 件 严 中 创建 一 个 名 为 LegacyRoute.cs 
的 类 文件 ， 用 于 实现 IRouter 接 口 ， 如 代码 清单 16- 
14 所 示 。 





代码 清单 16-14 Infrastructure 文件 夹 下 的 LegacyRoute.cs 文 件 
的 内 容 





using Microsoft.AspNetCore.Http; 
using Microsoft.AspNetCore. Routing; 
using System; 

using System.Ling; 

using System.Text; 

using System. Threading. Tasks; 


namespace UrlsAndRoutes.Infrastructure { 
public class LegacyRoute : IRouter { 
private string[] urls; 


public LegacyRoute(params string[] targetUrls) 


this.urls = targetUrls; 


public Task RouteAsync(RouteContext context) { 


string requestedUrl = context.HttpContext.R 
equest.Path 
.Value.TrimEnd('/'); 


if (urls.Contains(requestedUrl, StringCompa 
rer.OrdinalIgnoreCase)) { 
context.Handler = async ctx => { 

HttpResponse response = ctx.Respons 
e; 

byte[] bytes = Encoding.ASCII.GetBy 
tes($"URL: {requestedUr1}"); 

await response.Body.WriteAsync(byte 
S, @, bytes.Length); 


3 


} 
return Task.CompletedTask; 


} 


public VirtualPathData GetVirtualPath(VirtualPa 
thContext context) { 
return null; 





LecagyRoute 类 实现 了 IRouter 接 口 ， 但 只 定义 
了 用 于 处 理 传 入 请 求 的 RouteAsync 方 法 ; 我 们 将 在 
后 面 的 内 容 中 添加 处 理 传 出 URL 的 方法 。 








RouteAsync 方 法 中 只 有 几 条 语句 ， 但 它们 的 工 
作 依 赖 于 一 些 重要 的 ASP.NET 类 型 。 我 们 先 从 方法 
签名 开始 介绍 : 


public async Task RouteAsync(RouteContext context) { 


RouteAsync 方 法 负责 评估 是 售 可 以 处 理 请 求 ， 
如 果 可 以 ， 束 可 以 通过 生成 啊 应 并 发 送 回 客 户 端 来 
管理 整个 过 程 。 因 为 RouteAsync 方 法 返回 一 个 Task 
对 象 ， 所 以 这 个 过 程 是 异步 执行 的 。 








RouteAsync 方 法 使 用 了 RouteContext 参 数 ， 从 
而 提供 对 请 求 的 所有 已 知 信息 的 访问 ， 并 提供 将 啊 
应 发 送 回 客户 端 所 需 的 功能 。RouteContext 关 在 命 
名 空间 Microsoft.AspNetCore.Routing 中 定义 ， 有 3 个 
属性 ， 如 表 16-4 所 示 。 





表 16-4 ”RouteContext 类 中 定义 的 属性 














属性 描述 




















返回 一 个 Microsoft.AspNetCore.Routing.RouteData 对 象 ， 当 编写 依赖 于 MVC 功 
RouteData | 能 的 自 定义 路 由 时 ， 该 对 象 用 于 定义 控制 器 、 操 作 方 法 以 及 用 于 处 理 请 求 的 










































































返回 一 个 Microsoft.AspNetCore.Http.HttpContext 对 象 ， 该 对 象 提供 了 访问 


HttpContext ee ; : T 
HTTP 请 求 的 详细 信息 以 及 生成 HTTP 响 应 的 方法 



























































用 于 为 路 由 系统 提供 处 理 请 求 的 RequestDelegate。 如 果 未 设置 该 属性 ， 路 由 
系统 将 继续 按照 应 用 设置 的 路 由 集合 工作 























路 由 系统 调用 RouteAsync 方 法 来 处 理应 用 中 的 
每 个 路 由 ， 并 在 每 次 调用 后 检查 Handler 属 性 的 值 。 
如 果 Handler 属 性 已 设置 为 RequestDelegate， 足 由 就 
为 路 由 系统 提供 可 以 处 理 请 求 的 委托 ， 并 调用 委托 
以 生成 啊 应 。 以 下 是 RequestDelegate 的 签名 ， 
RequestDelegate 定 义 在 Microsoft.AspNetCore.Http 命 
名 空间 中 。 








using System.Threading.TasKs ; 


namespace Microsoft.AspNetCore.Http { 
public delegate Task RequestDelegate(HttpContext co 


ntext) ; 
} 


RequestDelegate 接 收 HttpContext 对 象 并 返回 一 
个 任务 来 生成 啊 应 。 如 有 条 没有 为 任何 路 由 设置 
Handler 属 性 ， 路 由 系统 便 得 知 应 用 程序 无 法 处 理 请 
求 ， 因 而 生成 404-Not Found 响 应 。 








考虑 到 这 一 点 ，RouteAsync 方 法 的 实现 必须 确 

定 是 个 可 以 处 理 通 第 需要 HttpContext 的 请 求 。 在 该 
例 中 ， 使 用 了 HttpContext.Request 属 性， 访 属 性 返 
回 描述 请 求 的 
Microsoft.AspNetCore.Http.HttpRequest 对 象 。 
HttpRequest 对 象 提供 对 有 关 请 求 的 所 有 可 用 信息 的 
访问 ， 包 括 尖 文件 、 主 体 以 及 请 求 友 起 地 址 的 详细 
言 轧 。Path 属 性 最 有 趣 ， 因 为 它 提供 了 客户 靖 用 送 
的 URL 请 求 的 详细 信息 。Path 属 性 会 返回 一 个 
PathString 对 象 ， 该 对 象 提供 了 一 些 有 用 的 方法 来 编 
写 和 比较 URL 路 径 。 但 这 里 使 用 了 Value 属性 ， 
































为 它 将 URL 的 整个 路 径 部 分 作为 字符 串 提供 了 ， 从 
而 可 以 与 支持 的 URL 集 合 进行 比较 。URL 可 由 
LegacyRoute 构 造 函 数 接收 。 


string requestedUrl = context .HttpContext .Request.Path . 
Value.TrimEnd('/'); 


if (urls.Contains(requestedUrl, StringComparer.Ordinall 
gnoreCase)) { 








a RHAFF, teh Ay MEH 
AppendTrailingSlash 配 置 选项 进行 添加 。 因 为 在 
URL 路 径 的 最 后 会 有 禾 枉 ， 所 以 需要 使 用 TrimEnd 
方法 来 去 除 URL 尾 部 的 斜 杠 。 





如 果 请 求 的 路 径 已 由 LegacyRoute 配 置 为 支持 
路 径 ， 那 么 将 使 用 一 个 用 于 生成 啊 应 的 Lambda 函 数 
来 设置 Handler 属 性 ， 如 下 所 示 : 











context.Handler = async ctx => { 
HttpResponse response = ctx.Response; 


byte[] bytes = Encoding.ASCII.GetBytes($"URL: {requ 
estedUrl1}"); 

await response.Body.WriteAsync(bytes, ©, bytes.Leng 
th); 
}; 





HttpContext.Response 属 性 会 返回 一 个 
HttpResponse 对 象 ， 访 对象 可 用 于 创建 对 客户 端的 
啊 应 ， 以 及 提供 对 发 送 到 客户 端的 头 文件 和 内 容 的 
访问 。 这 里 使 用 HttpResponse.Body.WriteAsync 方 法 
异步 写 入 一 个 简单 的 ASCII 字 符 串 作为 啊 应 ， 虽 然 
在 正式 的 项 目 中 不 应 该 这 么 做 ， 但 这 允许 生成 啊 
应 ， 而 不 必 选 择 和 演 染 视图 《下 一 草 会 介绍 如 何在 
MVC 中 选择 可 演 染 视图 〉。 











当 Handler 属 性 被 设置 时 ， 路 由 系统 知道 对 路 由 
的 搜索 已 经 完成 ， 并 且 可 以 调用 委托 来 生成 对 客户 
端的 啊 应 





1) 应 用 目 定 义 路 由 类 








到 目前 为 止 ， 一 直 用 于 创建 路 由 的 MapRoute 扩 
展 方法 不 文 持 使 用 自 定 义 路 由 类 。 要 使 用 
LegacyRoute 关 ， 必 须 采 取 不 同 的 方法 ， 如 代码 清 
单 16-15 所 示 。 


代码 清单 16-15 在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 
应 用 自 定 义 路 由 类 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.AspNetCore.Routing.Constraints; 
using Microsoft.AspNetCore. Routing; 

using UrlsAndRoutes.Infrastructure; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.Configure<RouteOptions>(options => 
{ 
options.ConstraintMap.Add("weekday", ty 
peof (WeekDayConstraint) ) ; 


options.LowercaseUrls = true; 
options.AppendTrailingSlash = true; 
})3 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage() ; 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes.Routes.Add(new LegacyRoute( 
"/articles/Windows_3.1_Overview.htm 
1", 
"/old/.NET_1.0_Class_Library")); 


routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 
n=Index}/{id?}"); 


routes .MapRoute( 


name: out , 
template: "“outbound/{controller=Hom 
e}/{action=Index}") ; 
})3 








使 用 自 定义 路 由 类 时 ， 必 须 使 用 路 由 集合 上 的 
Add 方 法 来 注册 IRouter 实 现 类 。 在 本 例 中 ， 











LegacyRonute 构 造 函 数 的 参数 是 希望 自 定 义 路 由 文 
持 的 旧 URL。 可 以 通过 启动 应 用 程序 并 请 

求 /articles/Windows_3.1_Overview.html 来 查看 效 
果 。 目 定义 路 由 会 显示 请 求 的 URL， 如 图 16-6 所 
ZN o 





URL: /articles/Windows_3.1_Overview.html 


图 16-6 ”使 用 自 定义 路 由 
2) 路 由 到 MVC 控 制 器 


在 简单 的 URL 匹 配 字符 串 和 使 用 MVC 系 统 的 
控制 医 、 操 作 和 Razor 视 图 之 间 还 有 很 大 的 差距 。 
但 对 和 运 的 是 ， 不 必 在 创建 目 定 义 路 由 时 实现 这 些 功 
能 ，MVC 会 在 后 台 完 成 这 些 重 要 工作 。 为 了 使 用 
MVC 的 基础 架构 ， 在 Controllers 文 件 夹 中 添加 一 个 
名 为 LegacyController.cs 的 类 文件 并 用 它 定义 控制 








器 ， 如 代码 清单 16-16 所 示 。 


代码 清单 16-16 ”Controllers 文 件 夹 下 的 LegacyController.cs 文 件 
的 内 容 


using Microsoft.AspNetCore.Mvc; 
namespace UrlsAndRoutes.Controllers { 


public class LegacyController : Controller { 


public ViewResult GetLegacyUrl(string legacyUrl 


=> View( (object) legacyUr1) ; 





在 这 个 控制 器 中 ， 操 作 方 法 GetLegacyUrl 用 来 
接收 客户 端 发 来 的 包含 旧 UREL 的 参数 。 在 真实 的 项 
目 中 ， 在 这 个 控制 器 的 操作 方法 中 应 该 取 回 请 求 的 
文件 ， 但 这 里 只 是 在 视图 中 显示 URL。 














二 
提 ” 示 


在 代码 清单 16-16 中 ， 为 View 方 法 传 值 的 参数 
为 object 类 型 。View 方 法 的 一 个 重 载 版 本 可 以 使 用 
一 个 字符 串 来 指定 要 呈现 的 视图 的 名 称 ， 并 且 没 有 
发 生 转换 ，C# 编 译 器 认为 这 正 是 我 们 想 要 的 重 载 版 
本 。 为 了 避免 这 种 情况 ， 需 要 转换 为 object 类 型 ， 
以 便 显 式 地 调用 传递 视图 模型 的 重 载 版 本 ， 并 使 用 
默认 视图 。 也 可 以 通过 使 用 同时 具有 视图 名 称 和 视 
图 模型 的 重 载 版 本 来 解决 这 个 问题 ， 但 是 这 里 不 项 
望 在 操作 方法 和 视图 之 间 明 确 地 进行 关联 。 详 细 信 


已 .请 参见 第 17 章 。 














创建 Views/Legacy 文 件 夹 ， 并 添加 一 个 名 为 


GetLegacyUrl.cshtml 的 视图 ， 如 代码 清单 16-17 所 
示 。 视 图 将 显示 模型 的 值 ， 在 这 里 显示 的 是 客户 端 
请 求 的 URL。 











代码 清单 16-17 Views / Legacy 文 件 夹 下 的 
GetLegacyUrl.cshtml 文 件 的 内 容 


@model string 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Routing</title> 
<link rel="stylesheet" asp-href-include="1ib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 
<h2>GetLegacyURL</h2> 
The URL requested was: @Model 
</body> 
</html> 





在 代码 清单 16-18 中 ， 更 新 LegacyRoute 类 ， 从 
而 将 处 理 的 URL 路 由 到 Legacy 控 制 右 中 的 


GetLegacyUrl 操 作 方 法 。 


代码 清单 16-18 在 LegacyRoute.cs 文 件 中 将 URL 路 由 到 控制 器 





using Microsoft.AspNetCore.Http; 

using Microsoft.AspNetCore. Routing; 

using System; 

using System.Ling; 

using System.Text; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore.Mvc.Internal; 

using Microsoft.Extensions.DependencyInjection; 


namespace UrlsAndRoutes.Infrastructure { 
public class LegacyRoute : IRouter { 
private string[] urls; 
private IRouter mvcRoute; 


public LegacyRoute(IServiceProvider services, p 
arams string[] targetUrls) { 
this.urls = targetUrls; 
mvcRoute = services.GetRequiredService<MvcR 
outeHandler>(); 


} 


public async Task RouteAsync(RouteContext conte 


xt) { 
string requestedUrl = context.HttpContext.R 
equest.Path 
.Value.TrimEnd('/'); 


if (urls.Contains(requestedUrl, StringCompa 


rer.OrdinalIgnoreCase)) { 

context .RouteData.Values[ "controller" ] 
= "Legacy"; 

context.RouteData.Values["action"] = "G 
etLegacyUr1"; 

context.RouteData.Values["legacyUrl"] = 

requestedUr1 ; 
await mvcRoute.RouteAsync(context) ; 
} 
} 


public VirtualPathData GetVirtualPath(VirtualPa 
thContext context) { 
return null; 





Microsoft.AspNetCore.Mvc.Internal.MvcRouteHa 
类 提供 了 使 用 controller 和 action 卢 段 变量 定位 控制 
AR DUT ERIE TIA HAG AG RK El Pot Ll 
这 个 类 可 以 由 目 定义 的 IRouter 实 现 来 调用 ，IRouter 
实现 提供 了 controller 和 aciton 的 值 以 及 所 需 的 任何 
其 他 值 ， 比 如 操作 方法 的 参数 。 








代码 清单 16-18 创 建 了 一 个 MvcRouteHandler 实 


例 ， 以 把 任务 委派 给 控制 顷 。 为 了 实现 这 些 ， 病 要 
给 路 由 提供 数据 ， 如 下 所 示 : 


context.RouteData.Values["controller"] = "Legacy"; 


context.RouteData.Values["action"] = "GetLegacyUr1"; 
context.RouteData.Values["legacyUrl"]| = requestedUr1; 





RouteContext.RouteData.Values 属 性 会 返回 一 个 
用 于 辣 MvcRouteHandler 类 提供 数据 值 的 字典 。 在 
默认 路 由 系统 中 ， 可 通过 将 URL 模 式 应 用 到 请 求 来 
创建 数据 值 。 但 在 自 定 义 路 由 类 中 ， 已 经 对 值 进行 
了 便 编 码 ， 以 便 始 终 将 目标 定位 到 旧版 控制 左上 的 
GetLegacyUrl 操 作 。 不 同 请 求 之 间 唯 一 更 改 的 是 
legacyUrl 数 据 什 ， 它 航 设 置 为 请 求 URL， 并 将 被 用 
作 由 操作 方法 接收 的 相同 名 称 的 参数 。 














在 代码 清单 16-18 的 最 后 ， 碍 找 和 使 用 控制 右 
类 来 处 理 请 求 : 


await mvcRoute.RouteAsync(context) ; 


4, controller. action#llegacyUri{i Hy 
RouteContext 对 象 将 被 传递 给 MvcRouteHandler 对 象 
的 RouteAsync 方 法 ， 该 方法 负 员 对 请 求 做 进一步 处 
理 ， 包 括 设 置 Handler 属 性 。 因 此 ，LegacyRoute 类 
可 以 专注 于 决定 处 理 哪 些 URL， 而 不 会 陷入 直接 使 
FA Pe hil as AWA o 








在 本 例 中 ，MvcRouteHandler 对 象 必须 作为 服 
务 进行 请 求 ， 第 18 章 会 解释 原因 。 为 了 问 
LegacyRoute 构 造 函 数据 供用 于 创建 
MvcRouteHandler 的 IServiceProvider 对 象 ， 可 以 更 新 
路 由 的 定义 语句 ， 以 便 在 Startup 类 中 提供 对 应 用 程 
序 服务 的 访问 ， 如 代码 清单 16-19 所 示 。 


代码 清单 16-19 在 UrlsAndRoutes 文 件 夹 下 的 Startup 类 中 提供 
对 应 用 程序 服务 的 访问 








using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.AspNetCore.Routing.Constraints; 
using Microsoft.AspNetCore. Routing; 

using UrlsAndRoutes.Infrastructure; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.Configure<RouteOptions>(options => 
{ 
options.ConstraintMap.Add("weekday", ty 
peof (WeekDayConstraint)); 
options.LowercaseUrls = true; 
options.AppendTrailingSlash = true; 
}); 


services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 
routes .Routes.Add(new LegacyRoute( 
app.ApplicationServices, 


"/articles/Windows_3.1_Overview.htm 
"/old/.NET_1.0_Class_Library")); 


routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 
n=Index}/{id?}"); 


routes .MapRoute( 
name: "out", 
template: "“outbound/{controller=Hom 
e}/{action=Index}") ; 
})3 





如 果 再 次 月 动 应 用 程序 并 请 求 地 
址 /articles/Windows _3.1_Overview.html， 你 将 看 到 
简单 的 文本 啊 应 现 已 被 视图 的 输出 符 换 ， 如 图 16-7 
所 示 。 





¢ G |© bocathost:54 wy: 


GetLegacyURL 


The URL requeste 


图 16-7 ”委托 处 理 控制 器 和 操作 


2. 创建 传 出 的 URL 


为 了 文 持 生成 传 出 的 URL， 需 要 在 
LegacyRoute 类 中 实现 GetVirtualPath 方 法 ， 如 代码 
清单 16-20 所 示 。 


代码 清单 16-20 ”在 Infrastructure 文 件 夹 下 的 LegacyRoute.cs 文 
件 中 生成 传 出 的 URL 





using Microsoft.AspNetCore.Http; 

using Microsoft.AspNetCore. Routing; 

using System; 

using System.Ling; 

using System.Text; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore.Mvc.Internal; 

using Microsoft.Extensions.DependencyInjection; 


namespace UrlsAndRoutes.Infrastructure { 
public class LegacyRoute : IRouter { 
private string[] urls; 
private IRouter mvcRoute; 


public LegacyRoute(IServiceProvider services, p 
arams string[] targetUrls) { 
this.urls = targetUrls; 
mvcRoute = services.GetRequiredService<MvcR 
outeHandler>(); 


} 


public async Task RouteAsync(RouteContext conte 


xt) { 


string requestedUrl = context.HttpContext.R 
equest.Path 
.Value.TrimEnd('/'); 


if (urls.Contains(requestedUrl, StringCompa 

rer.OrdinalIgnoreCase)) { 

context.RouteData.Values[ "controller" | 
= "Legacy"; 

context.RouteData.Values["action"] = "G 
etLegacyUr1"; 

context.RouteData.Values["legacyUrl"] = 

requestedUr1; 
await mvcRoute.RouteAsync(context) ; 


} 
} 


public VirtualPathData GetVirtualPath(VirtualPa 
thContext context) { 
if (context.Values.ContainsKey("legacyUr1") 
) { 
string url = context.Values["legacyUr1" 
] as string; 
if (urls.Contains(url)) { 
return new VirtualPathData(this, ur 
1); 
} 


} 


return null; 





路 由 系统 调用 Startup 类 中 定义 的 每 个 路 由 的 
GetVirtualPath 方 法 ， 使 每 个 路 由 都 有 机 会 生成 应 用 
程序 需要 的 传 出 URL。GetVirtualPath 方 法 的 参数 是 
一 个 VirtualPathContext 对 象 ， 用 于 提供 有 关上 所 需 
URL 的 信息 。 表 16-5 介 绍 了 VirtualPathContext 类 的 
属性 。 





表 16-5 ”VirtualPathContext 类 的 属性 


pm mm 
or lm 
poe fem 回 可 用 于 片段 变量 的 所 有 值 的 字典 ， 并 按 名 称 进行 索引 
























































































































































返回 有 助 于 生成 URL 的 值 的 字典 ， 但 不 会 将 它们 合并 到 结果 中 。 当 实现 
AmbientValues 
,的 路 由 类 时 ， 这 个 字典 通常 为 空 
























































在 本 例 中 ， 使 用 Values 属 性 获取 一 个 名 为 
legacyUrl 的 值 ， 如 果 能 匹配 路 由 配置 文 持 的 URL， 





就 返回 一 个 VirtualPathData 对 象 ， 从 而 为 路 由 系统 
提供 URL 的 详细 信息 。VirtualPathData 构 造 函 数 的 
参数 是 生成 URL 和 URL 本 号 的 IRouter。 


return new VirtualPathData(this, url); 


代码 清单 16-21 修 改 了 Result.cshtml 视 图 文件 ， 
以 要 求 以 目 定 义 视 图 为 目标 的 传 出 URL。 














代码 清单 16-21 在 Views/Shared 文 件 夹 下 的 Result.cshtml 文 件 
中 使 用 自 定 义 路 由 类 生成 传 出 的 URL 





@model Result 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Routing</title> 
<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 


<table class="table table-bordered table-striped ta 
ble-sm"> 
<tr><th>Controller:</th><td>@Model.Controller</ 
td></tr> 
<tr><th>Action:</th><td>@Model .Action</td></tr> 
@foreach (string key in Model.Data.Keys) { 
<tr><th>@key :</th><td>@Model .Data[ key ]</td 
></tr> 
} 
</table> 
<a asp-route-legacyurl="/articles/Windows 3.1 0verv 
iew.html" 
class="btn btn-primary"> 
This is an outgoing URL 


</a> 
<p> 
URL: @Url.Action(null, null, 
new { legacyurl = "/articles/Windows_3.1 Ove 

rview.html" }) 

</p> 
</body> 
</html> 





在 本 例 中 ， 不 需要 为 标签 助手 的 传 出 路 由 指定 





控制 融和 操作 ， 因 为 它们 不 在 URL 生 成 中 使 用 。 考 
处 到 这 一 点 ， 在 a 元 素 中 省 略 了 asp-controller 和 asp- 
action 标 签 助手 属性 。 当 生成 URL 时 ， 出 于 相同 的 
原因 ， 将 Un.Action 辅 助 方法 的 前 两 个 参数 设置 为 


null. 








如 果 运 行 应 用 程序 并 在 默认 URL 的 啊 应 中 查看 
HTML， 你 将 看 到 自 定义 路 由 类 已 用 于 创建 URL， 
如 下 上 所 示 : 





<a class="btn btn-primary" href="/articles/windows_3.1_ 
overview. html/"> 


This is an outgoing URL 
</a> 
<p>URL: /articles/windows_3.1_overview.html/</p> 





附加 到 URL 尾 部 的 斜 杠 是 将 Startend.cs 文 件 中 
的 AppendTrailingSlash 配 置 选项 设置 为 true 的 结果 ， 
并 且 需 要 注意 的 是 ， 匹 配 的 传 入 路 由 能 够 匹配 添加 
了 和 斜 杠 的 URL。 


提 ZN 


如 来 在 HTML 啊 应 中 看 到 的 URL 古 不 同 的 格 
sk, Ew 
legacyurl=%2Farticles%2FWindows_3.1_Overview.htr 
那么 说 明 自 定义 路 由 没有 被 用 于 生成 URL， 应 用 程 
序 已 经 调用 了 其 他 的 路 由 规则 。 由 于 没有 指定 控制 
器 或 操作 ， 因 此 Home 控 制 嚣 上 的 Index 操 作 方 法 将 
成 为 目标 ，legacyUrl 值 将 被 添加 到 URL 查 询 字 符 串 
中 。 如 果 发 生 这 种 情况 ， 要 在 GetVirtualPath 方 法 
中 将 IsBound 属 性 设置 为 tue， 检 查 Startup.cs 文 件 中 
的 配置 是 否 为 LegacyRoute 构 造 函 数 指定 了 正确 的 
URL， 并 且 确 认 自 定义 路 由 定义 在 其 他 任何 路 由 之 
HIJ o 








16.4 ”使 用 区 域 


ASP.NET Core MVC 支 持 将 Web 应 用 程序 组 织 


到 各 个 区 域 Carea) ， 每 个 区 域 代 表 应 用 程序 的 功 
Bebo), WUE, iret. BP SCRE. EKA 
项 目 中 非 童 有用， 因为 所 有 控制 器 、 视 图 和 模型 都 
有 一 组 文件 夹 可 能 会 变 得 难以 管理 。 





每 个 MVC 区 域 部 有 目 己 的 文件 夹 结构 ， 允 许 
保持 一 切 独 立 分 开 。 这 就 可 以 更 明确 哪些 项 目 元 素 
与 应 用 程序 的 每 个 功能 区 域 相关 ， 可 帮助 多 个 开 友 
人 员 在 项 目 上 进行 工作 而 不 会 相互 冲突 。 区 域 主要 
通过 路 由 系统 进行 文 持 ， 这 吏 是 将 此 功能 与 URL 和 
路 由 一 起 描述 的 原因 。 本 节 将 介绍 如 何在 MVC 项 目 
中 设置 和 使 用 区 域 。 


16.4.1 创建 区 域 


为 了 创建 区 域 ， 需 要 将 一 些 文件 夹 讨 加 到 项 目 
中 。 最 上 层 的 文件 夹 名 为 Areas， 所 有 的 区 域 都 要 
包含 在 该 文件 夹 中 。 每 个 区 域 部 包含 目 己 的 








Controllers、Views 和 Models 文 件 夹 。 在 本 章 中 ， 我 
们 将 创建 一 个 名 为 Admin 的 区 域 ， 这 意味 着 需要 创 

建 一 组 文件 来。 为 了 准备 示例 项 目 ， 请 创建 表 16-6 

中 的 所 有 文件 夹 。 


表 16-6 准备 区 域 所 需 的 文件 夹 


en 
EE | nA | 





















































Areas/Admin/Views 该 文件 夹 将 包含 Admin 区 域 的 视 医 
Areas/Admin/Views/Home 该 文件 夹 将 包含 Admin 区 域 中 Home 控 制 器 的 视图 
Areas/Admin/Models 该 文件 夹 将 包含 Admin 区 域 的 模型 


虽然 每 个 区 域 都 是 相互 独立 的 ， 但 许多 MVC 
功能 依赖 于 标准 的 C# 或 .NET 功 能 ， 如 命名 空间 。 











为 了 让 区 域 更 容易 使 用 ， 首 移 要 在 Views 文 件 夹 中 
引入 文件 ， 这 样 在 视图 中 使 用 模型 时 束 不 需要 再 写 
命名 空间 名 ， 并 且 可 以 使 用 标签 助手 。 在 
Areas/Admin/Views 文 件 夹 中 创建 一 个 名 为 
_ViewImports.cshtml 的 视图 并 引入 文件 ， 添 加 的 语 
句 如 代码 清单 16-22 所 示 。 











代码 清单 16-22 ”Areas/Admin/Views 文 件 夹 下 的 
_ViewImports.cshtml 文 件 的 内 容 


@using UrlsAndRoutes.Areas.Admin.Models 
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 
16.4.2 创建 区 域 路 由 


要 使 用 区 域 ， 必 须 在 Startup.cs 文 件 中 添加 包含 
区 域 片 段 变量 的 路 由 ， 如 代码 清单 16-23 所 示 。 





代码 清单 16-23 在 UrlsAndRoutes 文 件 夹 下 的 Startup.cs 文 件 中 
添加 区 域 厂 段 路 由 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.AspNetCore.Routing.Constraints; 
using Microsoft.AspNetCore. Routing; 

using UrlsAndRoutes.Infrastructure; 


namespace UrlsAndRoutes { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.Configure<RouteOptions>(options => 
{ 
options.ConstraintMap.Add("weekday", ty 
peof (WeekDayConstraint)); 
options.LowercaseUrls = true; 
options.AppendTrailingSlash = true; 
}); 


services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 

app.UseDeveloperExceptionPage(); 
app.UseStatusCodePages(); 
app.UseStaticFiles(); 
app.UseMvc(routes => { 

routes .MapRoute( 

name: "areas", 


template: "{area:exists}/{controlle 
r=Home}/{action=Index}") ; 


routes.Routes.Add(new LegacyRoute( 
app.ApplicationServices, 
"/articles/Windows_3.1 Overview.htm 


"/old/.NET_1.@ Class _Library")); 


routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 
n=Index}/{id?}"); 


routes .MapRoute( 
name: "out", 
template: "“outbound/{controller=Hom 
e}/{action=Index}") ; 


3 











区 域 族 段 变 量 用 于 匹配 特定 区 域 中 控制 右 的 
URL。 在 这 里 ， 按 照 标准 的 URL 格 式 ， 可 以 设置 成 
任何 希望 的 格式 。 用 于 对 区 域 添 加 文 持 的 路 由 应 该 
出 现在 不 太 有 具体 的 路 由 之 前 ， 以 确保 URL 被 正确 匹 
配 。exists 约 束 用 于 确保 请 求 仅 与 应 用 程序 中 定义 的 
X da VU AC 








16.4.3 HAKE 


可 以 像 在 MVC 应 用 程序 的 主要 部 分 一 样 ， 在 
区 域 中 创建 控制 右 、 视 图 和 模型 。 要 创建 模型 ， 可 
右 击 Areas/Admin/Models 文 件 夹 ， 从 弹出 的 菜单 中 
选择 Add -、Class 并 创建 一 个 名 为 Person.cs 的 类 文 
件 ， 其 中 的 内 容 如 代码 清单 16-24 所 示 。 


代码 清单 16-24 Areas/Admin/Models 文 件 夹 下 的 Person.cs 文 件 
的 内 容 


namespace UrlsAndRoutes.Areas.Admin.Models { 
public class Person { 
public string Name { get; set; } 


public string City { get; set; } 
} 





} 


Bl EPS Hill as, FY 77d Areas/Admin/Controllers 
SCTE IE, SALE BA Sie HE PE Add — Class 并 创建 一 
个 名 为 HomeController.cs 的 类 文件 ， 用 于 定义 控制 
器 的 内 容 ， 如 代码 清单 16-25 所 示 。 


代码 清单 16-25 ”Areas/Admin/Controllers 文 件 夹 下 的 
HomeController.cs 文 件 的 内 容 


using Microsoft.AspNetCore.Mvc; 
using UrlsAndRoutes.Areas.Admin.Models; 


namespace UrlsAndRoutes.Areas.Admin.Controllers { 


[Area( "Admin" ) ] 
public class HomeController : Controller { 
private Person[ | data = new Person[] { 
new Person { Name = "Alice", City = "London 


new Person { Name = "Bob", City = "Paris" } 


new Person { Name "Joe", City "New York 
}; 


public ViewResult Index() => View(data); 





Br AD Fa rll as Ae Pop EE Fa ld AS, LAR on EE E Hill ASD 
同 的 是 ， 为 了 将 控制 器 与 区 域 相 关联 ， 必 须 在 控制 
器 上 设置 Area 特 性 。 


[Area("Admin")] 


public class HomeController : Controller { 


ORCA Areat eth, Emar ce X ERA — eB 
分 ， 即 使 控制 器 是 在 应 用 程序 的 主要 部 分 定义 的 也 
是 如 此 。 缺 少 Area 特 性 可 能 导致 奇怪 的 结果 。 在 使 
用 区 域 时 ， 如 果 程序 没有 得 到 预期 的 结果 ， 那 么 要 
做 的 第 一 件 事 融 是 检查 和 是否 正确 添加 了 区 域 的 Area 


特性 。 











人 
提示 


如 果 使 用 特性 设置 路 由 《如 第 15 章 所 述 ) ， 则 
可 以 使 用 Route 特性 的 参数 中 的 [areal] 标 记 来 引用 
Area 特 性 指定 的 区 域 . 





[Route("[area]/app/[controller]/actions/[action]/{id:we 
ekday?}")] 


{E Areas/Admin/Views/Home X fF F Arpi — A 
名 为 Index.cshtml 的 Razor 视 图 ， 内 容 见 代码 清单 16- 
26. 


代码 清单 16-26 ”Areas/Admin/Views/Home 文 件 夹 下 的 
Index.cshtml 文 件 的 内 容 





@model Person[ ] 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 

<meta name="viewport" content="width=device-width" 
/> 

<title>Areas</title> 

<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 

<table class="table table-bordered table-striped ta 
ble-sm"> 

<tr><th>Name</th><th>City</th></tr> 


@foreach (Person p in Model) { 
<tr><td>@p.Name</td><td>@p.City</td></tr> 


} 
</table> 
</body> 
</html> 





Index 视 图 的 模型 是 一 个 Person 对 象 数 组 。 由 于 
在 代码 清单 16-26 中 己 经 为 视图 引入 文件 ， 因 此 在 
这 里 可 以 直接 使 用 Person 类 型 而 不 需要 再 写 命 名 空 
间 。 运 行 应 用 程序 并 请 求 URL /Admin 以 测试 创建 
的 区 域 ， 结 果 如 图 16-8 所 示 。 








图 16-8 ”使 用 区 域 


了 解 区 域 对 MVC 应 用 程序 的 影响 





了 解 区 域 对 其 余 应 用 程序 的 影响 是 非常 重要 
的 。 这 里 创建 了 名 为 Admin 的 区 域 ， 但 在 应 用 程序 
中 还 有 名 为 Admin 的 控制 左 。 在 创建 区 域 之 前 ， 
对 /Admin URLI W RKKA K ET E H xH Admin 
Fe thll asl IndextkE. ÆI K, RRA e 
Admin 区 域 中 Home 控 制 占 的 Index 操 作 (区 域 为 
controller 和 action 户 段 变 量 提供 了 默认 值 ) 。 这 种 
更 改 可 能 会 市 来 很 多 意外 的 情况 ， 使 用 区 域 的 最 佳 
实践 是 将 其 用 于 项 目的 初始 控制 句 命 名 方案 。 如 采 
要 在 已 经 建立 的 应 用 程序 中 添加 区 域 ， 束 必须 仔细 
考虑 区 域 可 能 对 路 由 市 来 的 影响 。 








16.4.4 ”生成 区 域 中 指 癌 操 作 的 链接 


不 需要 米 取 任何 特殊 步 又 就 能 创建 指 癌 当前 请 
求 所 在 的 同一 MVC 区 域 中 操作 的 链接 。MVC 检 训 


到 请 求 与 特定 区 域 相 关 ， 并 确保 传 出 的 URL 只 能 在 
为 该 区 域 定 义 的 路 由 中 找到 匹配 项 。 例 如 ， 在 
Areas/Admin/ Views/Home 文 件 夹 下 的 Index.cshtml 
文件 中 添加 一 个 新 的 元 素 ， 如 代码 清单 16-27 所 
ZN o 





代码 清单 16-27 在 Areas/Admin/Views/Home 文 件 夹 下 的 
Index.cshtml 文 件 中 添加 销 点 





@model Person[ ] 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Areas</title> 
<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 
<table class="table table-bordered table-striped ta 
ble-sm"> 
<tr><th>Name</th><th>City</th></tr> 
@foreach (Person p in Model) { 
<tr><td>@p.Name</td><td>@p.City</td></tr> 
} 


</table> 
<a asp-action="Index" asp-controller="Home">Link</a> 


</body> 
</html> 





如 果 运 行 应 用 程序 并 请 求 URL /admin， 你 将 看 
到 啊 应 包含 以 下 元 素 : 


<a href="/admin/">Link</a> 


路 由 系统 选择 了 用 于 生成 传 出 URL 的 区 域 路 
由 ， 并 考虑 了 可 用 于 controller 和 action 片段 变量 的 
默认 值 。 


必须 为 路 由 系统 提供 区 域 片 段 的 值 ， 以 创建 指 
癌 应 用 程序 的 不 同 区 域 或 主要 部 分 中 的 操作 的 链 
接 ， 如 代码 清单 16-28 所 示 。 





代码 清单 16-28 在 Areas/Admin/Views/Home 文 件 夹 下 的 
Index.cshtml 文 件 中 生成 指 癌 不 同 区 域 的 链接 


@model Person[ ] 





@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Areas</title> 
<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 
<table class="table table-bordered table-striped ta 
ble-sm"> 
<tr><th>Name</th><th>City</th></tr> 
@foreach (Person p in Model) { 
<tr><td>@p.Name</td><td>@p.City</td></tr> 
} 
</table> 
<a asp-action="Index" asp-controller="Home">Link</a 
> 


<a asp-action="Index" asp-controller="Home" asp-rou 
te-area="">Link</a> 
</body> 
</html> 





asp-route-area 属 性 用 于 设置 区 域 片 段 变量 的 
值 。 在 这 种 情况 下 ， 将 这 个 属性 设置 为 空 字符 串 ， 
以 指向 应 用 程序 的 主要 部 分 ， 并 生成 以 下 HIML 元 
素 : 











<a href="/">Link</a> 


如 果 控 制 占 中 有 多 个 区 域 并 且 想 要 路 由 到 它 
们 ， 则 需要 使 用 区 域名 称 代 将 上 面 的 空 字 符 串 。 








16.5 URL 模式 最 佳 实践 


在 介绍 了 人 上面 这 些 内 容 后 ， 你 可 能 还 不 知道 从 
ng 
的 URL 设 计 越 来 越 受 到 重视 ， 一 些 重要 的 设计 原则 
也 应 运 而 生 。 如 果 遵 循 这 些 设计 模式 ， 将 能 够 提高 
应 用 程序 的 可 用 性 、 兼 容 性 和 搜索 引擎 排名 。 











16.5.1 保持 URL 的 整洁 性 


下 面 是 提高 URL 整 洁 性 的 一 些 建 议 。 





。 设计 的 URL 应 该 用 来 描述 内 容 而 不 是 体现 应 用 
程序 实现 的 细节 ， 比 如 应 该 使 
用 /Articles/AnnualReport 而 不 是 


Website_v2/CachedContentServer/FromCache/Ann 
尽量 在 URL 中 使 用 内 容 标题 而 不 是 数字 ID， 比 
如 应 尽量 使 用 /Articles/AnnualReport 而 不 

是 /Articles/2392。 如 有 果 必 须 使 用 数字 ID 〈 以 区 分 
其 有 相同 标题 的 项 ， 或 避免 使 用 标题 会 找 项 所 
需 的 额外 数据 库 查 询 )， 则 建议 使 

用 /Articles/2392/AnnualReport。 虽 然 这 个 URL 看 
起 来 需要 更 长 的 录入 时 间 ， 但 是 它 对 用 户 来 说 
更 有 意义 ， 并 且 有 助 于 提 蜗 搜索 引擎 排 名 。 应 
用 可 以 直接 忽略 标题 ， 利 用 ID 来 租 找 与 之 匹配 
的 页 面 。 

不 要 使 用 HTML 页 面 的 文件 扩展 名 《例如 .aspx 
或 .mvyc) ， 但 是 要 使 用 专门 的 文件 类 型 ( 例 

如 .jpg、.pdf 和 .zip〉。 必 须 正确 设置 MIME 类 
型 ，Web 浏 览 器 不 关心 文件 扩展 名 ， 但 人 们 仍 
然 硕 望 PDF 文件 以 .pdf 结尾 。 

创建 的 URL 要 具有 层次 感 〈 例 

如 /Products/Menswear/Shirts/Red) ， 以 便 访 问 者 
可 以 猜测 父 闫 别 的 URL。 

不 区 分 大 小 写 。 默 认 情 况 下 ，ASP.NET Core 路 














由 系统 不 区 分 大 小 写 。 

。 和 避免 使 用 符号 、 代 人 码 和 字符 序列 。 如 果 需 要 单 
词 分 隔 符 ， 可 使 用 连 字 符 《〈 比 如 /my-great- 
article) 。 下 男 线 并 不 友好 。 在 URL 编 侣 中 ， 至 
格 的 编码 很 奇怪 (/my+greattarticle) ， 也 让 人 
难受 C/my%20great%20article) 。 

。 不 要 更 改 URL。 无 效 的 链接 会 导致 丢失 业务 。 
当 更 改 URL 时 ， 可 以 通过 重 定 同 继续 文 持 旧 的 
URL 模 式 。 

。 保持 一 致 。 在 整个 应 用 程序 中 采用 一 种 URL 格 
Ts 








网 址 应 该 很 简单 ， 易 于 输入 ， 并 且 人 性 化 《可 
编辑 ) 且 具 有 持久 性 ， 还 应 该 可 视 化 网 站 结构 。 
URL 可 用 性 专家 Jakob Nielsen 扩 展 了 这 个 主题 。 
Web 专 家 Tim Berners-Lee 也 提供 了 类 似 的 建议 。 





16.5.2 GET 方法 和 POST 方法 : 选择 最 合适 的 方 
2 


经 验 法 则 是 ， 将 GET 请 求 应 用 于 所 有 只 读 信 息 
的 检索 ， 而 将 POST 请 求 应 用 于 任何 更 改 应 用 程序 
状态 的 操作 。 在 符合 标准 的 条 球 中 ，GET 请 求 是 为 
了 安全 交互 〈 除 信息 检索 以 外 没有 副作用 ) ， 而 
POST 请 求 则 用 于 不 安全 的 交互 〈 做 出 决定 或 更 改 
EEA) 。 这 些 约定 是 由 万 维 网 联盟 CW3C) 制 


定 的 。 











GET 请 求 是 可 寻 址 的 ， 所 有 的 信息 都 包含 在 
URL 中 ， 因 此 可 以 将 这 些 网 址 收藏 为 书签 或 创建 链 
接 。 





需要 在 更 改 状 态 时 使 用 GET 方 法 ， 当 Google 
Web Accelerator 在 2005 年 问 公众 发 布 时 ， 很 多 网 站 
开发 人 员 有 过 惨痛 的 教训 。Google Web Accelerator 
收录 每 个 页 面 的 所 有 和 链接， 这 在 HTTP 中 是 合法 
的 ， 因 为 GET 请 求 应 该 是 安全 有 的。 但 是 ， 许 多 Web 
开发 人 员 忽 略 了 HTTP 约 定 ， 并 在 应 用 程序 中 使 用 














了 “删除 商品 ?或 < 添加 到 购物 车 ”的 链接 ， 混 乱 也 就 
随 之 而 来 。 


一 家 公司 认为 目 己 的 管理 系统 正在 遭受 攻击 ， 
因为 所 有 的 内 容 都 在 不 断 地 被 删除 ， 后 来 该 公司 才 
发 现 原 来 是 搜索 引擎 抓 取 工具 抓 取 了 管理 页 面 的 
URL， 并 且 在 抓 取 所 有 删除 数据 的 链接 。 如 果 有 二 
份 验证 ， 瓯 可 以 保护 你 不 受 此 影响 ， 但 无 法 让 你 免 
用 搜索 引擎 爬虫 的 困扰 。 


16.6 小结 


本 章 展 示 了 路 由 系统 的 高 级 功能 ， 如 何 生成 出 
站 链接 和 URL， 以 及 如 何 自 定义 路 由 系统 。 此 外 ， 
本 章 还 介绍 了 区 域 的 概念 ， 并 讨论 了 如 何 创 建 有 效 
且 有 意义 的 URL 模 式 。 下 一 章 将 介绍 控制 器 和 操 
作 ， 这 是 ASP.NET Core MVC 的 核心 内 容 ， 除 详细 
解释 这 些 内 容 之 外 ， 还 将 展示 如 何 使 用 它们 在 应 用 








第 17 章 ”控制 器 和 操作 


每 个 应 用 程序 的 请 求 都 由 控制 器 处 理 。 在 
ASP.NET Core MVC 中 ， 控 制 器 是 包含 处 理 请 求 所 
需 邮 辑 的 .NET 类 。 第 3 章 介 绍 过 控制 右 的 作用 是 封 
装 应 用 程序 逻辑 。 这 意味 着 控制 器 负责 处 理 传 入 的 
请 求 ， 对 模型 执行 操作 ， 并 选择 要 呈现 给 用 户 的 视 
图 。 





只 要 不 偶 离 属于 模型 和 视图 的 责任 区 域 ， 控 制 
胡 束 可 以 目 由 地 处 理 目 认 为 合适 的 任何 方式 的 请 
求 。 这 意味 痢 控 制 右 既 不 包 合 或 存储 数据 ， 也 不 生 
成 用 户 界 面 。 





本 章 将 展示 如 何 实现 控 制 器 以 及 使 用 控制 器 接 
收 和 生成 数据 的 不 同方 式 。 表 17-1 展 示 了 在 上 下 文 
中 使 用 的 控制 器 。 





表 17-1 在 上 下 文中 使 用 的 控制 右 




















判 器 包含 月 





端的 响应 的 逻辑 


控制 器 有 什 
么 用 ? 





控制 器 是 MVC 项 目的 核心 ， 并 包含 Web 应 用 程序 的 逻辑 





于 接收 请 求 、 更 新 应 用 程序 状态 或 模型 以 及 选择 将 发 送 给 客户 














空 制 器 是 调 月 














刚 开 始 使 
一 个 更 为 具体 的 问题 是 各 
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隐患 或 局 限 



































法 来 处 理 














HTTP 请 求 的 C# 类 。 这 些 方法 可 以 负责 直接 为 










































































控制 器 ， 这 意味 着 一 些 可 能 
































7217-25245 [AB 


` 是 作为 控制 器 的 类 被 意外 























更 常见 的 方式 是 返回 操作 结果 ， 告 诉 MVC 应 该 如 何 去 响 应 


jMVC 时 ， 可 以 轻松 创建 包含 更 适合 于 模型 或 视图 功能 的 控制 器 。 
何以 Controller 为 名 的 公共 类 都 会 被 假定 为 MVC 的 






































空 制 器 是 MVC 应 用 程序 的 核心 部 分 





草 要 介绍 的 操作 。 


表 17-2 本章 要 介绍 的 操作 


于 处 理 HTTP 请 求 








操作 


方法 


代码 清单 


























个 公共 类 ， 名 称 以 Controller 为 结尾 或 “| 代码 清单 17-7 一 代码 清 
自 Controller 类 单 17-9 
































获取 HTTP 请 求 的 oe eee 代码 清单 17-10 一 代码 
ennai jcontext 对 象 或 定义 操作 方法 参数 a 
详细 信息 清单 17-13 















































从 操作 方法 生成 结 | 直接 使 用 context 结 果 对 象 或 创建 操作 结果 对 “| 代码 清单 17-14 一 代码 
R 清单 17-16 





























代码 清单 17-17 一 代码 
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清单 17-24 














生成 HTML 结 果 

















代码 清单 17-25 一 代码 
清单 17-30 








创建 重 定向 结果 




















代码 清单 17-31 一 代码 
清单 17-35 
































代码 清单 17-36 和 代码 


` 


清单 17-37 














HTTP 状态 码 











17.1 准备 示例 项 目 


在 本 章 中 ， 将 使 用 ASP.NET Core Web 
Application (.NET Core) 模板 创建 一 个 名 为 


ControllersAndActions 的 新 的 Empty 项 目 。 代 码 清单 
17-1 在 Startup 类 中 添加 了 一 些 语句 ， 以 启用 MVC 框 
架 和 其 他 中 间 件 。 


本 章 包括 用 于 关键 功能 的 单元 测试 。 为 简洁 起 
见 ， 没 有 将 单元 测试 项 目 包含 在 创建 示例 项 目的 说 
明 中 。 可 以 按照 第 7 章 中 描述 的 过 程 创 建 测 试 项 
目 ， 或 从 本 书 的 GitHub 存 储 库 下 载 该 项 目 。 


代码 清单 17-1 ”在 ControllersAndActions 文 件 夹 下 的 Startup.cs 文 
件 中 添加 MVC 和 其 他 中 间 件 


using 
using 
using 
using 
using 
using 
using 
using 


System; 

System.Collections.Generic; 

System. Ling; 

System. Threading.Tasks; 
Microsoft.AspNetCore. Builder; 
Microsoft.AspNetCore.Hosting; 
Microsoft.AspNetCore.Http; 
Microsoft.Extensions.DependencyInjection; 


namespace ControllersAndActions { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 


n services) { 


services.AddMvc(); 
services.AddMemoryCache() ; 
services.AddSession(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 

app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 

app.UseSession(); 
app.UseMvcWithDefaultRoute(); 





AddMemoryCache 和 AddSession 方 法 将 创建 会 
话 管理 所 需 的 服务 。UseSession 方 法 用 于 将 一 个 中 





间 件 添加 到 管道 中 ， 将 会 话 数据 与 请 求 天 联 起 来 ， 
并 将 cookie 诡 加 到 啊 应 中 ， 以 确保 将 来 的 请 求 能 够 
锌 识别 。 必 须 在 UseMvc 方 法 之 前 调用 UseSession 方 
法 ， 以 便 会 话 组 件 能 够 在 到 达 MVC 中 间 件 之 前 截获 
请 求 ， 并 且 可 以 在 生成 后 修改 啊 应 。 其 他 几 个 方法 
用 于 设置 第 14 章 中 摘 述 的 标准 包 。 








准备 视图 





本 章 的 重点 古 控制 器 及 其 操作 方法 ， 本 章 将 定 
义 控制 器 类 。 这 里 将 定义 一 些 视图 ， 它 们 可 以 帮助 
展示 控制 右 类 的 工作 方式 。 这 些 视图 创建 在 
Views/Shared 文 件 夹 中 ， 以 便 可 以 在 本 章 后 面 创建 
的 任何 控制 器 中 使 用 它们 。 创 建 Views/Shared 文 件 
来， 添加 一 个 名 为 Result.cshtml 的 Razor 视 图 文件 ， 
内 容 如 代码 清单 17-2 所 示 。 


代码 清单 17-2 ”Views/Shared 文 件 夹 下 的 Result.cshtml 文 件 中 的 


@model string 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Controllers and Actions</title> 
<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 
Model Data: @Model 
</body> 
</html> 





用 于 Result 视 图 的 模型 是 一 个 字符 串 ， 这 将 允 
许 显 示人 简单 的 消 奶 。 接 下 来 ， 在 Views/Shared 文 件 
夹 中 创建 一 个 名 为 DictionaryResult.cshtml 的 文件 ， 
内 容 如 代码 清单 17-3 所 示 ， 用 于 DictionaryResult 视 
图 的 模型 是 一 个 字典 ， 用 于 显示 比 前 一 个 视图 更 复 
ARH BSG o 














代码 清单 17-3 ”Views/Shared 文 件 夹 下 的 


DictionaryResult.cshtml 文 件 的 内 容 


@model IDictionary<string, string> 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Controllers and Actions</title> 
<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 
<table class="table table-bordered table-sm table-s 
triped"> 
<tr><th>Name</th><th>Value</th></tr> 
@foreach (string key in Model.Keys) { 
<tr><td>@key</td><td>@Model[key]</td></tr> 
} 
</table> 
</body> 
</html> 








接 下 来 ， 在 Views/Shared 文 件 夹 中 创建 一 个 名 
为 SimpleForm.cshtml 的 文件 ， 内 容 如 代码 清单 17-4 
所 示 。 顾 名 思 义 ，SimpleForm 视 图 包含 一 个 简单 的 
HTML 表 单 ， 用 于 提交 数据 。 


代码 清单 17-4 Views/Shared 文 件 夹 下 的 SimpleForm.cshtml 文 
件 的 内 容 


@{ Layout = null; } 
<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Controllers and Actions</title> 
<link rel="stylesheet" asp-href-include="1ib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 
<form method="post" asp-action="ReceiveForm" > 
<div class="form-group"> 
<label for="name">Name:</label> 
<input class="form-control" name="name" /> 
</div> 
<div class="form-group"> 
<label for="name">City:</label> 
<input class="form-control" name="city" /> 
</div> 
<button class="btn btn-primary center-block" ty 
pe="submit" >Submit</button> 
</form> 
</body> 
</html> 








这 些 视图 使 用 内 置 的 标签 助手 从 路 由 系统 生成 
URL。 要 启用 标签 助手 ， 可 在 Views 文 件 夹 中 创建 








一 个 名 为 _ViewImports.cshtml 的 视图 导入 文件 ， 内 
容 如 代码 清单 17-5 所 示 。 


代码 清单 17-5 Views 文件 夹 下 的 _ViewImports.cshtml 文 件 的 内 


P 


谷 


@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 


在 Views/Shared 文 件 夹 中 创建 的 视图 都 依赖 于 
Bootstrap CSS 包 。 要 将 Bootstrap 添 加 到 项 目 中 ， 可 
使 用 Bower Configuration Filet tx @!) 4 bower.json < 
件 ， 添 加 的 内 容 如 代码 清单 17-6 所 示 。 





代码 清单 17-6 ”在 ControllersAndActions 文 件 夹 下 的 bower.json 
文件 中 添加 包 


"name": "asp.net", 
"private": true, 


"dependencies": { 
"bootstrap": "4.0@.0-alpha.6" 





17.2 ”理解 控制 器 


控制 右 是 C# 类 ， 其 公共 方法 〈 称 为 action 或 操 
作 方 法 ) 负责 处 理 HTTP 请 求 并 准备 将 返回 给 客户 
端的 响应 。MVC 使 用 第 15 章 和 第 16 章 描述 的 路 由 系 
统 来 确定 处 理 请 求 所 需 的 控制 器 类 和 操作 方法 。 然 
后 ，MVC 创 建 一 个 控制 器 类 的 新 实例 ， 调 用 操作 方 
法 ， 并 使 用 调用 结果 来 回 客户 端 输出 啊 应 。 

















MVC 提 供 了 上 下 文 数据 的 操作 方法 ， 以 便 它 
们 能 够 理解 如 何 处 理 请 求 。 有 大 量 的 上 下 文 数据 ， 
它们 描述 了 当前 请 求 的 所 有 和 内容、 正在 准备 的 啊 
应 、 由 路 由 系统 提取 的 数据 以 及 用 户 吴 份 的 详细 信 


[A 


人 J 已 vo 





当 MVC 调 用 操作 方法 时 ， 操 作 方法 的 啊 应 描 
述 了 应 该 及 送 给 客户 器 的 啊 应 。 最 向 见 的 啊 应 是 创 
建 并 渔 染 Razor 视 图 ， 所 以 操作 方法 使 用 啊 应 来 告 








诉 MVC 要 使 用 哪个 视图 ， 以 及 应 该 提供 哪些 视图 模 
型 数据 。 此 外 还 能 提供 其 他 类 型 的 啊 应 ， 并 且 操 作 
方法 可 以 从 MVC 中 发 送 HTTP 重 定向 到 客户 端 以 发 
送 复杂 的 数据 对 象 。 


这 意味 痢 可 从 3 个 重要 的 方面 来 理解 控制 大 。 
首先 ， 了 解 如 何 定义 控制 希 ， 以 便 MVC 可 以 使 用 它 
们 来 处 理 请 求 。 控 制 占 只 是 C# 类 ， 但 和 一 般 类 的 创 
建 方法 不 同 ， 了 解 它 们 之 间 的 兰 异 很 重要 。17.3 节 
将 解释 如 何 定 义 控制 春 。 








其 次 ， 了 解 MVC 如 何 提供 上 下 文 数据 的 操作 
方法 也 是 很 重要 的 。 获 取 所 需 的 上 下 文 数 据 对 于 有 
效 的 Web 应 用 开发 非常 重要 ， 通 过 定义 一 组 用 于 描 
述 操作 方法 所 需 的 所 有 内 容 的 类 ，MVC 可 以 使 Web 
应 用 开发 变 得 容易 。17.4 节 将 解释 MVC 如 何 描述 请 
求 和 响应。 





最 后 ， 了 解 操 作 方 法 如 何 产 生 啊 应 也 很 重要 。 
操作 方法 很 少 需要 自己 生成 HTTP 啊 应 ， 你 需要 知 
道 如 何 使 用 MVC 生 成 所 需 的 啊 应 ，17.5 节 将 对 此 进 
行 解释 。 


17.3 ”创建 控制 器 





到 目前 为 止 ， 几乎 所 有 半 市 部 使 用 了 控制 瞩 。 
现在 是 时 候 回 头 来 看 看 它们 是 如 何 定 义 的 。 本 节 将 
描述 控制 硕 的 不 同 创建 方式 ， 并 解释 它们 之 间 的 和 


Ey 
Ff o 











17.3.1 创建 POCO 控制 器 


MVC 配 置 十 分 方便 灵活 ， 这 意味 着 MVC 应 用 
程序 中 的 控制 器 是 自动 发 现 的 ， 而 不 用 在 配置 文件 
中 定义 。 基 本 的 友 现 过 程 很 简单 ;名称 以 Controller 
结尾 的 任何 公共 类 者 是 控制 蓝 ， 其 中 定义 的 任何 公 


共 方 法 都 是 操作 方法 。 为 了 演示 这 是 如 何 工 作 的 ， 
在 项 目 中 添加 Controllers 文 件 夹 ， 并 在 其 中 添加 一 
个 名 为 PocoController.cs 的 类 文件 ， 内 容 如 代码 清单 
17-7 所 示 。 


p 
提示 


虽然 约定 是 将 控制 右 放 在 Controllers 文 件 夹 
中 ， 但 是 可 以 将 它们 放 在 项 目的 任何 位 置 ，MVC 仍 
然 会 目 动 找 到 它们 。 





代码 清单 17-7 ”Controllers 文 件 夹 下 的 PocoController.cs 文 件 的 
内 容 


namespace ControllersAndActions.Controllers { 


public class PocoController { 


public string Index() => "This is a POCO contro 


ller"; 
} 
} 





PocoController 类 满足 了 MVC 控 制 器 的 基础 标 
准 ， 它 定义 了 一 个 名 为 Index 的 公共 方法 ， 可 作为 一 
个 操作 方法 并 返回 一 个 字符 串 。 


PocoController 类 是 POCO 控制 器 的 范例 ， 其 中 
POCO 表示 “普通 的 旧 CLR 对 象 ”， 并 且 指 的 是 使 用 
标准 .NET 功 能 实现 控制 器 ， 而 不 直接 依赖 于 
ASP.NET Core MVC 提 供 的 API。 


要 测试 POCO 控 制 顷 ， 可 局 动 应 用 程序 并 请 求 
URL /Poco/Index/。 路 由 系统 将 使 用 默认 URL 模 式 
匹配 请 求 ， 并 将 请 求 指向 PocoController 类 的 Index 
方法 ， 结 果 如 图 17-1 所 示 。 





图 17-1 使 用 POCO 控制 器 


使 用 属性 标识 调整 控制 占 


对 POCO 控制 器 的 文 持 并 不 总 是 投 和 希望 的 方式 
工作 。 一 个 第 见 的 问题 是 ，MVC 将 以 单元 测试 中 的 
假 关 作为 控制 器 。 避 免 这 个 问题 的 最 简单 方法 是 注 
重 类 名 ， 避 人 免 名 字 类 似 于 FakeController。 如 果 无 法 
避免 ， 那 么 可 以 使 用 命名 空间 
Microsoft.AspNetCore.Mvc 中 定义 的 NonController 属 
性 ， 用 于 告诉 MVC 这 个 类 不 是 控制 器 类 。 
NonAction 属 性 可 应 用 于 方法 ， 以 阻止 它们 被 作为 
PAFTA 








在 菜 些 项 目 中 ， 可 能 无 法 在 作为 POCO 控制 右 
的 类 上 者 循 命名 约定 。 通 过 应 用 Controller 属 性 〈 在 
命名 空间 Microsoft.AspNetCore.Mvc 中 定义 ) ， 可 以 
告诉 MVC 这 是 控制 右 类 ， 即 使 不 符合 POCO 选 择 标 
{EE 


使 用 MVC API 


PocoController 类 是 MVC 识 别 控制 器 以 及 简单 
使 用 控制 器 的 有 用 演示 。 但 是 ， 不 依赖 
Microsoft.AspnetCore 命 名 空间 的 纯 POCO 控 制 器 并 
不 是 特别 有 用 ， 因 为 它们 无 法 访问 MVC 为 处 理 请 求 
提供 的 功能 


可 以 通过 从 Microsoft. AspnetCore 命 名 空间 创建 
新 的 实例 来 访问 MVC API 的 某 些 功能 。 作 为 一 个 简 


单 的 例子 ，POCO 类 可 以 通过 从 操作 方法 返回 一 个 
ViewResult 对 象 来 使 MVC 呈 现 Razor 视 图 ， 如 代码 
清单 17-8 所 示 〈《 详 见 17.5 节 的 ViewResult 类 ) 。 


代码 清单 17-8 在 Controllers 文 件 夹 下 的 PocoController.cs 文 件 
中 使 用 ASP.NET API 


using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.ModelBinding; 
using Microsoft.AspNetCore.Mvc.ViewFeatures ; 
namespace ControllersAndActions.Controllers { 


public class PocoController { 


public ViewResult Index() => new ViewResult() { 
ViewName = "Result", 


ViewData = new ViewDataDictionary( 
new EmptyModelMetadataProvider(), 
new ModelStateDictionary()) { 
Model = $"This is a POCO contro 





这 不 再 是 纯 POCO 控 制 嚣 ， 因 为 它 直 接 依赖 于 
MVC API。 除 纯粹 之 外 ， 它 比 前 一 个 例子 有 用 得 





多 ， 因 为 它 要 求 MVC 泻 染 一 个 Razor 视 图 。 


但 是 ， 代 码 很 复杂 。 为 了 创建 一 个 ViewResult 
对 象 ， 需 要 创建 ViewDataDictionary、 
EmptyModelMetadataProvider 和 
ModelStateDictionary 对 象 ， 这 需要 访问 3 个 不 同 的 
命名 空间 (后面 的 草 市 将 摘 述 这 些 类 型 所 涉及 的 特 
性 ) 。 此 例 的 重点 是 说 明 MVC 提 供 的 功能 可 以 直接 
访问 ， 即 使 结 末 有 点 混乱 。 








我 们 使 用 一 个 字符 串 作 为 视图 模型 来 泻 染 
Result.cshtml， 如 果 你 运行 应 用 程序 并 请 求 URL 
/Poco/Index， 你 看 到 的 结果 将 如 图 17-2 所 示 。 





€ C | © localhost S 3 


Model Data: This is a POCO controller 


图 17-2 ”直接 使 用 MVC API 请 求 的 结果 


17.3.2 ”使 用 控制 右 基 类 





之 前 的 例子 展示 了 如 何 从 POCO 控 制 器 开始 ， 
并 对 其 进行 扩展 来 访问 MVC 功 能 。 这 种 方法 揭示 了 
MVC 的 工作 原理 ， 这 是 很 有 用 的 知识 ， 但 是 这 样 会 
使 POCO 控 制 舌 难以 编写 、 阅 读 和 维护 。 











创建 控制 右 的 一 种 更 简单 的 方法 是 从 
Microsoft.AspNetCore.Mvc.Controller 类 派生 类 ， 基 
类 定义 了 一 些 方法 和 属性 ， 从 而 以 更 简洁 有 用 的 方 
式 访问 MVC 功 能 。 为 了 沽 示 ， 将 一 个 名 为 
DerivedController.cs 的 基文 件 添 加 到 Controllers 文 件 
夹 中 ， 内 容 如 代码 清单 17-9 所 示 。 


代码 清单 17-9 在 Controllers 文 件 夹 下 的 由 Controller 类 派生 出 
的 DerivedController.cs 文 件 





using Microsoft.AspNetCore.Mvc; 


namespace ControllersAndActions.Controllers { 


public class DerivedController : Controller { 


public ViewResult Index() => 
View("Result", $"This is a derived controll 





如 果 运 行 应 用 程序 并 访问 /Derived/Index， 你 看 
到 的 结果 将 如 图 17-3 所 示 。 





17-3 ”使 用 Controller 基 类 


代码 清单 17-9 中 的 控制 器 执行 与 代码 清单 17-8 
中 的 控制 锅 相 同 的 操作 《要 求 MVC 泻 染 具 有 字符 串 
视图 模型 的 视图 ) ， 但 是 使 用 Controller 基 类 意味 看 
可 以 更 简单 地 实现 结果 。 














关键 的 变化 是 ， 可 以 使 用 View 方 法 创建 演 染 
Razor 视 图 所 需 的 ViewResult 对 象 ， 而 不 必 直 接 在 操 
作 方 法 中 进行 实例 化 。View 方 法 继承 自 Controller 基 


类 ，ViewResult 对 象 仍然 以 相同 的 方式 创建 ， 只 是 
没有 多 余 代码 来 扰乱 操作 方法 。 从 Controller 类 进行 
派生 不 会 改变 控制 器 的 工作 方式 ， 而 只 是 简化 了 编 
写 的 代码 以 完成 常见 任务 。 


YO 
注 意 


MVC 会 为 要 求 处 理 的 每 个 请 求 创建 一 个 控制 
需 关 的 新 实例 ， 这 意味 看 不 需要 同步 对 操作 方法 或 
实例 属性 和 字段 的 访问 。 第 18 草 将 要 描述 的 共 孚 对 
象 〈 包 括 数据 库 和 单 例 服务 ) 可 以 同时 使 用 ， 并 且 
必须 根据 规则 来 编写 。 





17.4 ”接收 上 下 文 数据 


无 论 如 何 定义 控制 顷 ， 它 们 几乎 都 不 会 匆 立 存 
在 ， 通 第 需要 从 传 入 的 请 求 中 访问 数据 ， 例 如 查询 
字符 串 值 、 表 单 值 以 及 路 由 系统 从 URL 中 解析 的 参 
数 ， 统 称 为 上 下 文 数据 。 访 问 上 下 文 数据 有 3 种 主 
BT eG 





。 从 一 组 Context 对 象 中 提取 。 
。 接收 数据 作为 操作 方法 的 参数 。 
。 明确 地 调用 框架 的 模型 绑 定 功能 。 





这 里 将 介绍 如 何在 操作 方法 获取 和 输入， 重点 是 
使 用 Context 对 象 和 操作 方法 参数 。 第 26 章 将 介绍 模 
型 绑 定 。 


17.4.1 ”从 Context 对 象 中 接收 数据 


(EH Controller Æ 38 8!) GES till 45 WY EA BZ 


是 可 以 方便 地 访问 描述 当前 请 求 、 正 在 准备 的 啊 应 
和 应 用 程序 状态 的 一 组 Context 对 象 。 表 17-3 描 述 了 
用 于 上 下 文 数据 的 一 些 有 用 的 控制 器 类 属性 。 


表 17-3 用 于 上 下 文 数 据 的 一 些 有 用 的 控制 器 类 属性 


返回 一 个 HttpRequest 对 象 ， 用 于 描述 从 客户 端 收 到 的 请 求 
返回 用 于 创建 客户 端 响应 的 HttpResponse 对 象 































































































返回 一 个 HttpContext 对 象 ， 它 是 由 其 他 属性 (如 请 求 和 响应 ) 返回 的 许多 对 
HttpContext | 象 的 源 ， 它 还 提供 了 有 关 可 用 的 HTTP 功能 的 信息 以 及 对 低级 功能 〈 如 Web 套 





























接 字 ) 的 访问 


返回 由 路 由 系统 在 匹配 请 求 时 生成 的 RouteData 对 象 
返回 一 个 ModelStateDictionary 对 象 ， 用 于 验证 客户 端 发 送 的 数 志 
返回 一 个 ClaimsPrincipal 对 象 ， 用 于 描述 已 发 出 请 求 的 用 户 


许多 控制 蕉 的 编写 不 需要 使 用 表 17-3 中 的 属 
性 ， 因 为 上 下 文 数据 也 可 以 通过 后 面 几 章 描述 的 功 































































































能 提供 ， 这 更 符合 MVC 开 发 风格 。 例 如 ， 大 多 数控 
制 器 不 需要 使 用 Request 属 性 来 获取 正在 处 理 的 
HTTP 请 求 的 详细 信息 ， 因 为 通过 第 26 章 描述 的 模 
型 绑 定 过 程 可 以 获得 相同 的 数据 。 





但 是 ， 理 解 和 使 用 Context 对 象 仍然 有 用 ， 而 且 
它们 对 于 调试 很 有 用 。 代 人 码 清单 17-10 使 用 Request 
属性 来 访问 HTTP 请 求 中 的 标 头 。 





代码 清单 17-10 在 Controllers 文 件 夹 下 的 DerivedController.cs 
文件 中 使 用 上 下 文 数据 





using Microsoft.AspNetCore.Mvc; 
using System.Ling; 


namespace ControllersAndActions.Controllers { 
public class DerivedController : Controller { 


public ViewResult Index() => 
View("Result", $"This is a derived controll 
en) 


public ViewResult Headers() => View("Dictionary 
Result", 
Request.Headers.ToDictionary(kvp => kvp 


kvp => kvp.Value.First())); 





IEH Context xt R AREN GE — ZR AS [A] I RS 
和 命名 空间 。 用 来 获取 有 关 列 表 中 HTTP 请 求 的 上 
下 文 数 据 的 Controller.Request 属 性 会 返回 一 人 1 
HttpRequest 对 象 。 表 17-4 摘 述 了 在 编写 控制 器 时 有 
用 的 HttpRequest 必 性。 





表 17-4 有 用 的 HttpRequest 属 性 


mento 
wie | cits 

































































返回 按 名 称 索引 的 请 求 标 头 的 字典 
eee Cs 
























































回 按 名 称 索引 的 请 求 cookie 的 字典 
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Cookies 











可 使 用 Request.Headers 来 获取 标 头 的 字典 ， 并 
使 用 LINQ 对 其 进行 处 理 。 


View("DictionaryResult", Request.Headers.ToDictionary(k 


vp => kvp.Key, 
kvp => kvp.Value.First())); 





由 Request.Headers 属 性 返回 的 字典 使 用 
StringValues 结 构 存 储 每 个 标 头 的 值 ， 该 结构 在 
ASP.NET 中 用 于 表示 字符 串 值 序列 。HTTP 客 户 端 
可 以 为 HITP 标 头发 送 多 个 值 ， 但 是 这 里 只 和 想 显 示 
第 一 个 值 。 可 使 用 LINQ ToDictionary 方 法 为 每 个 标 
题 接 收 一 个 KeyValuePair<String,StringValues> 对 
象 ， 并 选择 第 一 个 值 。 结 果 是 包含 字符 串 值 的 字 
典 ， 可 以 由 DictionaryResult 视 图 显示 。 如 果 运 行 应 
用 程序 并 请 求 URL /Derived/Headers， 你 将 看 到 的 











得 出 关 似 于 图 17-4《〈 根 据 使 用 的 浏览 左 ， 标 头 及 值 
将 有 所 不 同 ) 。 
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图 17-4 ”显示 上 下 文 数据 


在 POCO 控制 磺 中 获取 上 和 下文 数据 








即使 它们 在 第 规 项 目 中 不 是 特别 有 用 ，POCO 
控制 锅 也 能 让 我 们 在 幕后 租 看 MVC 是 如 何 操作 的 。 
在 POCO 控制 器 中 获取 上 下 文 数据 是 一 个 问题 ， 
为 不 能 只 实例 化 自己 的 HttpRequest 或 HttpResponse 
对 象 ， 还 需要 那些 已 由 ASP.NET 创 建 并 由 所 有 在 处 
理 请 求 时 填充 了 数据 字段 的 中 间 件 更 新 的 对 象 。 


要 获取 上 下 文 数据 ，POCO 控 制 器 必须 要 求 


MVC 提 供 在 前 。 代 码 清单 17-11 更 新 了 

PocoController 类 以 添加 显示 HTTP 请 求 标 头 的 操作 

Ts 

代码 清单 17-11 ”在 Controllers 文 件 夹 下 的 PocoController.cs 文 件 
中 显示 上 下 文 数据 





using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.ModelBinding; 
using Microsoft.AspNetCore.Mvc.ViewFeatures; 
using System. Linq; 


namespace ControllersAndActions.Controllers { 
public class PocoController { 


[ControllerContext] 
public ControllerContext ControllerContext { ge 
t; set; } 


public ViewResult Index() => new ViewResult() { 
ViewName = "Result", 
ViewData = new ViewDataDictionary(new Empty 
ModelMetadataProvider(), 
new ModelStateDictionary() ) 
{ 
Model = $"This is a POCO controller" 
} 
}; 


public ViewResult Headers() => 


new ViewResult() { 
ViewName = "DictionaryResult", 
ViewData = new ViewDataDictionary( 
new EmptyModelMetadataProvider(), 
new ModelStateDictionary()) { 
Model = ControllerContext.HttpC 
ontext.Request.Headers 


.ToDictionary(kvp => kvp.Key, k 
vp => kvp.Value.First()) 





为 了 获取 上 下 文 数据 ， 可 定义 一 个 名 为 
ControllerContext 的 属性 ， 类 型 为 
ControllerContext， 并 使 用 同名 的 ControllerContext 
JR PE DEE TT 222 (HB o 


下 面 介绍 3 种 不 同 的 ControllerContext 的 用 途 。 
首先 ，Microsoft.AspNetCore.Mvc 命 名 空间 中 定义 的 
ControllerContext 类 用 于 使 用 ControllerContext 的 属 
性 〈 见 表 17-5) 汇集 控制 器 的 操作 方法 所 需 的 所 有 
Context 对 象 。 


表 17-5 “ControllerContext 的 属性 























返回 一 个 ActionDescriptor 对 象 ， 用 于 描述 操作 方法 


返回 一 个 HttpContext 对 象 ， 用 于 提供 HTTP 请 求 的 详细 信息 和 发 送 回 客户 
HttpContext i 
端的 HTTP 响 应 















































ModelState 返回 一 个 ModelStateDictionary 对 象 ， 用 于 验证 客户 端 发 送 的 数据 
Gon T ee ae 


通过 ControllerContext.HttpContext 属 性 可 访问 
HTTP 相 关 数 据 ， 该 属性 会 返回 一 人 
Microsoft.AspNetCore. Http.HttpContext 对 象 。 
HttpContext 类 合并 了 几 个 用 于 摘 述 请 求 的 不 同方 面 
的 对 象 ， 可 通过 HttpContext 的 属性 〈 见 表 17-6) 进 
行 访问 。 















































表 17-6 HttpContext 的 属性 


| | 




















属性 描述 


| 
返回 一 个 HttpResponse 对 象 ， 用 将 返回 给 客户 端的 响应 
















































































som | T. 
返回 一 个 ClaimPrincipal 对 象 ， 用 于 描述 与 请 求 关联 的 用 广 


























其 次 ，ControllerContext 属 性 用 于 描述 代码 清 
单 17-11 中 的 属性 ， 并 告诉 MVC 使 用 描述 当前 请 求 
的 ControllerContext 对 象 设置 属性 值 。 这 使 用 了 一 种 
称 为 依赖 注入 的 技术 ， 这 将 在 第 18 章 中 介绍 ，MVC 
将 使 用 该 属性 ， 在 使 用 操作 方法 处 理 请 求 之 前 为 控 
制 费 提供 上 下 文 数 据 。 


最 后 ，ControllerContext 是 属性 的 名 称 。 可 以 
在 目 己 的 POCO 控 制 器 中 使 用 任何 合法 的 C# 属 性 名 
称 ， 在 幕后 ，Controller 类 依赖 于 相同 的 





ControllerContext 类 的 上 下 文 数据 ， 该 类 使 用 相同 的 
ControllerContext 属 性 进行 装饰 。 表 17-3 中 摘 述 的 所 
有 控制 左 属 性 都 是 直接 使 用 ControllerContext 属 性 的 
更 方便 、 更 简洁 的 蔡 代 方法 ， 这 正 古 控制 器 类 提供 
的 属性 的 使 用 情况 。 例 如 ， 下 面 是 控制 器 类 中 的 
HttpContext 属 性 的 定义 : 








public HttpContext HttpContext { 
get { 
return ControllerContext.HttpContext ; 
} 





} 





HttpContext 属 性 只 是 获取 ControllerContext. 
HttpContext 属 性 值 的 一 种 手段 。 控 制 器 基 类 没有 魔 
法 : 它们 只 不 过 是 更 人 简单、 更 清晰 的 控制 器 ， 因 为 
第 见 任务 已 被 整合 到 方法 和 属性 中 。 如 有 和 需要， 可 
以 在 POCO 控制 右 中 重新 创建 目 己 所 需 的 内 容 。 
ASP.NET Core MVC 中 的 很 多 功能 都 是 非常 简单 

















的 ， 深 入 挖掘 细 蔬 ， 你 将 发 现 并 没有 特别 的 内 容 ， 
只 有 精心 设计 的 功能 ， 并 且 提 供 了 一 和 套 详细 的 
NuGet 包 。 如 果 有 了 时间， 建议 从 GitHub 下 载 MVC 源 
代码 并 进行 浏览 ， 从 而 确认 这 一 点 


17.4.2 ”使 用 操作 方法 参数 


一 些 上 下 文 数据 也 可 以 通过 I 
收 ， 这 可 以 让 我 们 编写 更 自然 且 优 雅 的 代码 。 
a a R E nities 
数据 时 。 为 了 比较 ， 下 面 演示 如 何 通过 Context 对 和 象 
获取 表单 数据 ， 然 后 通过 操作 方法 获取 参数 。 


表单 数据 可 通过 Controller 类 的 Request,Form 属 
EVI. AS iN, SINAN 
HomeController.cs 的 类 文件 ， 并 用 它 定义 派生 控制 
人 锅 ， 如 代码 消 单 17-12 所 示 。 


代码 清单 17-12 ”Controllers 文 件 夹 下 的 HomeController.cs 文 件 


的 内 容 


using Microsoft.AspNetCore.Mvc; 
namespace ControllersAndActions.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() => View("SimpleForm" ) 


public ViewResult ReceiveForm() { 
var name = Request.Form[ "name" ]; 
var city = Request.Form["city"]; 
return View("Result", $"{name} lives in {ci 





DY EFEZ FW Index Be (E77 AK St DAS BIT 
头 在 Views/Shared 中 创建 的 SimpleForm 视 图 。 我 们 
需要 关注 ReceiveForm 方 法 ， 以 使 用 HttpRequest 
context 对 象 从 请 求 中 获取 表单 数据 。 


如 表 17-4 所 示 ， 由 HttpRequest 类 定义 的 Form 属 
性 将 返回 一 个 包含 表单 数据 的 集合 ， 并 由 关联 的 





HTML 元 素 的 名 称 进 行 索引 。SimpleForm 视 图 中 有 
两 个 输入 元 素 Cname 和 city) ， 可 从 Context 对 象 中 
提取 它们 的 值 ， 并 使 用 它们 创建 一 个 字符 串 作 为 模 
型 传递 给 Result 视 图 。 





如 果 运 行 应 用 程序 并 请 求 URI 一 /Home， 将 
会 亚 示 一 个 表单 。 如 采 填 写字 段 并 单 击 Submit 欣 
钮 ， 浏 览 右 将 上 友 送 表单 数据 作为 HITP POST 请 求 的 
一 部 分 ， 由 ReceiveForm 方 法 处 理 ， 产 生 的 结果 如 
图 17-5 所 示 。 











图 17-5 “从 Context 对 象 获取 表单 数据 


代码 清单 17-12 所 示 的 方法 很 有 效 ， 但 是 还 有 


更 优雅 的 选择 。 操 作 方 法 可 以 定义 MVC 使 用 的 参 

数 ， 将 上 下 文 数据 传递 给 控制 器 ， 包 括 HITP 请 求 

的 详细 信息 。 这 比 直 接 从 Context 对 象 提取 更 简单 ， 

并 且 能 产生 更 容易 阅读 的 操作 方法 。 要 接收 表单 数 
据 ， 请 在 名 称 对 应 的 表单 数据 的 操作 方法 上 声明 参 
数 ， 如 代码 清单 17-13 所 示 。 














代码 清单 17-13 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 以 参数 方式 接收 上 下 文 数据 


using Microsoft.AspNetCore.Mvc; 
namespace ControllersAndActions.Controllers { 
public class HomeController : Controller { 
public ViewResult Index() => View("SimpleForm" ) 


public ViewResult ReceiveForm(string name, stri 
ng city) 


=> View("Result", $"{name} lives in {city}" 








修改 后 的 操作 方法 会 产生 相同 的 结果 ， 但 更 易 
于 阅读 和 理解 。MVC 将 通过 目 动 检查 Context 对 象 
(包括 请 求 字 人 符 串 、 表 单 和 RouteData 的 值 ) 来 提供 
操作 方法 参数 的 值 。 参 数 的 名 称 分 情况 处 理 ， 以 便 
可 以 通过 Request. Form["City"] 中 的 值 填充 名 为 city 
的 操作 方法 参数 。 以 上 方式 还 会 生成 更 容易 进行 单 
元 测试 的 操作 方法 ， 因 为 操作 方法 操作 的 值 可 作为 
利 规 的 C# 参 数 接收 ， 并 且 不 需要 Context 对 象 。 

















17.5 生成 啊 应 








操作 方法 在 处 理 完 请 求 之 后 ， 需 要 生成 啊 应 。 
有 许多 功能 可 用 于 从 操作 方法 生成 输出 ， 下 面 进行 
详细 介绍 。 








17.5.1 ”使 用 Context 对 象 生成 响应 








生成 输出 的 最 简单 方法 是 使 用 HttpResponse 


Context 对 象 ， 该 对 象 指 定 了 ASP.NET Core 如 何 访 
问 发 送 到 客户 端的 HTTP 响 应 。 表 17-7 描 述 了 由 
HttpResponse 类 提供 的 基本 属性 ， 访 类 定义 在 
Microsoft.AspNetCore.Http 命 名 空间 中 。 





表 17-7 HttpResponse 提 供 的 基本 属性 





属性 


用 于 设置 响应 的 HTTP 状 态 码 
ContentType 用 于 设置 响应 的 Content-Type 标 头 
































返回 将 包含 在 响应 中 的 HITP 标 头 的 字 ? 
返回 一 个 用 于 向 响应 添加 Cookies 的 集合 
返回 用 于 写 入 响应 的 主体 数据 的 System.IO.Stream 对 象 


代码 清单 17-14 更 新 了 Home 控 制 嚣 ， 从 而 在 
ReceivedForm 操 作 方 法 中 使 用 Controller.Request 属 
性 返回 HttpResponse 对 象 来 生成 啊 应 。 

















代码 清单 17-14 在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 生成 啊 应 


using Microsoft.AspNetCore.Mvc; 
using System.Text; 


namespace ControllersAndActions.Controllers { 
public class HomeController : Controller { 


public ViewResult Index() => View("SimpleForm" ) 


public void ReceiveForm(string name, string cit 


y) { 
Response.StatusCode = 200; 
Response.ContentType = "text/html"; 
byte[] content = Encoding.ASCII 
.GetBytes($"<html><body>{name} lives in 
{city}</body>"); 
Response.Body.WriteAsync(content, @, conten 
t.Length) ; 
} 
} 








但 这 种 生成 啊 应 的 方式 是 很 可 怕 的 ， 因 为 它 使 
用 C# 字 符 串 对 操作 方法 中 的 HIML 进 行 硬 编码 ， 这 
容易 出 错 且 难以 进行 单元 测试 。 但 这 种 方式 确实 有 











助 于 了 解 如 何在 硕 后 创建 啊 应 。 


还 有 比 直 接 使 用 HttpResponse 对 象 更 好 的 蔡 代 
方法 。MVC 在 底层 啊 应 的 基础 上 提供 了 一 个 更 有 用 
的 功能 ， 并 且 也 是 控制 器 工 作 的 核心 操作 结 
R. 








17.5.2 ”理解 操作 结果 





MVC 使 用 操作 结果 来 分 离 说 明 意 图 和 执行 意 
图 。 这 个 概念 很 简单 ， 但 是 首先 需要 一 些 时 间 才 能 
理解 。 





操作 方法 将 返回 一 个 从 
Microsoft.AspNetCore.Mvc 命 名 空间 实现 了 
IActionResult 接 口 的 对 象 ， 而 不 是 直接 使 用 
HttpResponse 对 象 。IActionResult 对 象 义 称 为 操作 结 
果 ， 它 描述 了 控制 右 应 该 如 何 啊 应 ， 例 如 呈现 视图 
或 将 客户 端 重 定 同 到 男 一 个 URL。 但 是 ， 它 不 会 直 











接生 成 响应 ， 而 是 通过 MVC 的 操作 结果 来 产生 结 
果 。 


YO 
vy =e 
ce. oe. 


操作 结果 系统 是 命令 模式 的 一 个 例子 。 命 令 模 
式 描述 了 一 种 场景 ， 以 存储 和 传递 这 样 的 对 象 一 一 
这 种 对 象 撞 述 了 要 执行 的 操作 。 


下 面 是 来 和 目 MVC 源 代码 的 IActionResult 接 口 的 
定义 : 


using System.Threading.TasKs ; 
namespace Microsoft.AspNetCore.Mvc { 


public interface IActionResult { 
Task ExecuteResultAsync(ActionContext context); 


I 


} 





这 个 接口 可 能 看 起 来 很 简单 ， 但 这 是 因为 
MVC 不 会 规定 操作 结果 可 以 产生 什么 样 的 啊 应 。 妆 
操作 方法 返回 操作 结果 时 ，MVC 将 调用 
ExecuteResultAsync 方 法 ， 该 方法 负责 生成 啊 应 以 
代表 操作 方法 。ActionContext 参 数 提 供 了 用 于 生成 
啊 应 的 上 下 文 数据 ， 包 括 HttpResponse 对 象 

(ActionContext 类 是 ControllerContext 有 的 超 类 ， 并 定 


义 了 表 17-5 中 摘 述 的 所 有 属性 〉。 

















为 了 演示 操作 结 末 如 何 工 作 ， 为 项 目 添 加 
Infrastructure 文 件 夹 ， 并 添加 一 个 名 为 
CustomHtmlResult.cs 的 类 文件 ， 内 容 如 代码 清单 17- 
15 所 示 。 


代码 清单 17-15 ”Infrastructure 文件 夹 下 的 CustomHtmlResult.cs 


文件 的 内 容 


using Microsoft.AspNetCore.Mvc; 
using System.Text; 
using System. Threading. Tasks; 


namespace ControllersAndActions.Infrastructure { 


public class CustomHtmlResult : IActionResult { 


public string Content { get; set; } 
public Task ExecuteResultAsync(ActionContext co 
ntext) { 
context .HttpContext.Response.StatusCode = 2 
00; 
context.HttpContext.Response.ContentType = 
"text/html"; 
byte[] content = Encoding.ASCII.GetBytes (Co 
ntent); 
return context.HttpContext.Response.Body.Wr 
iteAsync(content, 
@, content.Length); 





CustomHtmlResult 类 实现 了 IActionResult 接 
口 ， 其 ExecuteResultAsync 方 法 使 用 HttpResponse 对 
象 来 编写 HIML 啊 应 ， 其 中 包含 Content 属 性 的 值 。 
ExecuteResultAsync 方 法 必须 返回 一 个 Task 对 象 ， 以 





便 可 以 异步 生成 啊 应 ; 这 适用 于 CustomHtmlResult 
类 中 的 实现 ， 该 类 依赖 于 表示 啊 应 体 的 Stream 对 象 
的 WriteAsync 方 法 ， 并 返回 可 以 用 作 操 作 结 果 的 
Task 方 法 。 








在 代码 清单 17-16 中 ， 已 通过 在 Home 控 制 器 中 
使 用 操作 结果 简化 了 Home 控 制 器 的 ReceiveForm 操 
EJI e 


代码 清单 17-16 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 使 用 操作 结果 





using Microsoft.AspNetCore.Mvc; 
using System.Text; 
using ControllersAndActions.Infrastructure; 


namespace ControllersAndActions.Controllers { 
public class HomeController : Controller { 
public ViewResult Index() => View("SimpleForm" ) 
public IActionResult ReceiveForm(string name, s 


tring city) 
=> new CustomHtmlResult { 


Content = $"{name} lives in {city}" 





发 送 啊 应 的 代码 现在 已 与 啊 应 包含 的 数据 分 开 
定义 ， 这 简化 了 操作 方法 ， 并 允许 在 其 他 操作 方法 
中 生成 相同 闫 型 的 啊 应 ， 而 不 会 产生 重复 的 代码 。 





用 于 控制 融和 操作 的 单元 测试 





ASP.NET Core MVC 的 许多 部 分 是 为 了 方便 单 
元 测试 而 设计 的 ， 对 于 操作 和 控制 器 来 说 尤其 如 
此 。ASP.NET Core MVC 支 持 单元 测试 ， 具 体 表 现 
a ie 


。 可 以 在 Web 服 务 器 之 外 测试 操作 和 控制 器 。 

。 不 需要 解析 任何 HTML 来 测试 操作 方法 的 结果 。 
可 以 检查 返回 的 IActionResult 对 象 ， 以 确保 收 到 
预期 的 结果 。 


。 不 需要 侦 拟 客户 疹 请 求 。MVC 模 型 绑 定 系统 多 
许 编写 作为 方法 参数 接收 输入 的 操作 方法 。 为 
了 测试 操作 方法 ， 只 需要 直接 调用 操作 方法 ， 
并 提供 希望 的 参数 值 即 可 。 





本 章 将 介绍 如 何 为 不 同类 型 的 操作 结果 创建 单 
元 测试 。 有 关 设 置 单元 测试 项 目的 说 明 ， 请 参阅 第 
7 章 ， 或 从 GitHub 下 载 示 例 项 目 。 


17.5.3 生成 HTML 啊 应 


刚才 介绍 了 如 何 使 用 操作 结果 从 控制 右 类 中 获 
取 生 成 响应 的 代码 。ASP.NET Core MVC 提 供 了 更 
灵活 的 方法 来 生成 啊 应 使 用 ViewResult 类 。 








ViewResult 类 是 能 够 提供 对 Razor 视 网 引擎 的 访 
问 的 操作 结果 ， 访 引擎 处 理 .cshtml 文 件 以 合并 模型 
数据 ， 并 通过 HttpResponse 上下文 引擎 将 结果 发 送 


给 客户 中。 第 21 章 将 解释 视图 引擎 的 工作 原理 ， 在 
本 章 中 ， 重 点 是 使 用 ViewResult 类 作为 操作 结 








在 代码 清单 17-17 中 ， 已 经 用 ViewResult 蔡 换 了 
目 定义 的 操作 结果 类 ， 操 作 结 果 类 可 通过 Controller 
基 类 提供 的 View 方 法 创建 。 








代码 清单 17-17 使 用 Controllers 文 件 夹 下 的 HomeController.cs 
文件 中 的 ViewResult 类 


using Microsoft.AspNetCore.Mvc; 
using System.Text; 
using ControllersAndActions.Infrastructure; 


namespace ControllersAndActions.Controllers { 


public class HomeController : Controller { 


public ViewResult Index() => View("SimpleForm" ) 


public ViewResult ReceiveForm(string name, stri 
ng city) 
=> View("Result", $"{name} lives in {city}" 





可 以 直接 创建 ViewResult 对 象 ， 正 如 本 章 开 头 
的 POCO 控 制 占 中 演示 的 那样 ， 但 是 使 用 View 方 法 
更 简单 、 更 简洁 。Controller 类 提供 了 几 个 不 同 版 本 
的 View 方 法 ， 人 允许 选择 泻 染 的 视图 并 提供 模型 数 
据 ， 如 表 17-8 所 示 。 








表 17-8 ” Controller 类 中 的 View 方 法 


View 方 法 


为 与 操作 方法 关联 的 默认 视图 创建 一 个 ViewResult 对 象 ， 以 便 在 名 为 
View() MyAction 的 方法 中 调用 View()， 呈 现 名 为 MyAction.cshtml 的 视图 。 不 使 
用 模型 数据 






















































































Gene 创建 一 个 将 呈现 指定 视图 的 ViewResult 对 象 ， 调 用 View ("MyView" ) 
iew(view 
将 呈现 一 个 名 为 MyView.cshtml 的 视图 。 不 使 用 模型 数据 


, 为 与 操作 方法 关联 的 默认 视图 创建 一 个 ViewResult 对 象 ， 并 使 用 指定 对 
View(model) 
象 作为 模型 数据 
为 指定 的 视图 创建 一 个 ViewResult 对 象 ， 并 使 用 指定 对 象 作为 模型 数据 




















如 果 运 行 应 用 程序 并 提交 表单 ， 你 看 到 的 结 


将 如 图 17-6 所 示 。 





London 


图 17-6 ”使 用 ViewResult 对 象 生 成 HTML 响 应 结果 
1. 理解 对 视图 文件 的 搜索 


当 MVC 调 用 ViewResult 对 象 的 ExecuteResult- 
Async 方 法 时 ， 将 从 指定 的 视图 开始 搜索 。MVC 搜 
索 视 图 的 目录 顺序 是 与 配置 相关 的 约定 示例 。 不 需 
要 使 用 框架 注册 视图 文件 。 只 需要 将 它们 放 到 一 组 
己 知 位 置 ， 框 染 即 可 找到 它们 。 默 认 情 况 下 ，MVC 
KEI MAAR: 


/Views/<ControllerName>/<ViewName>.cshtml 
/Views/Shared/<ViewName>.cshtml 











搜索 从 包含 专用 于 当前 控制 器 的 视图 的 文件 夹 
开始 。 访 文件 夹 的 名 称 中 省 略 了 类 名 的 Controller 部 
分 ， 以 便 HomeController 类 的 文件 来 名 为 


Views/Home. 





如 果 视 图 名 未 在 ViewResult 对 象 中 指定 ， 就 使 
ee TAKS BPE Hill as 
来 说 ， 这 意味 着 将 使 用 方法 的 名 称 ， 以 使 与 Index 方 
法 关联 的 默认 视图 文件 为 Index.cshtml。 但 是 ， 如 果 
己 使 用 Route 属性 ， 那 么 与 操作 方法 关联 的 视图 名 
可 能 不 同 。 











如 果 控 制 苍 是 区 域 的 一 部 分 ， 如 第 16 章 所 述 ， 
则 搜索 位 置 也 会 不 同 。 


/Areas/<AreaName>/\iews/<ControlLerName>/<ViewName>.csh 
tml 


/Areas/<AreaName>/Views/Shared/<ViewName>.cshtml 
/Views/Shared/<ViewName>.cshtml 





MVC RIRA REFERTE. ~HE FI] 
Li, MEEHAN PR VETTE WIZE R . xE 
为 没有 在 示例 项 目 中 使 用 区 域 ， 所 以 代码 清单 17- 
18 中 的 操作 方法 会 使 MVC 通 过 查找 
Views/Home/Result.cshtml 文 件 来 开始 搜索 。 没 有 这 
样 的 文件 ， 所 以 搜索 继续 ，MVC 寻 找 
Views/Shared/Result.cshtml， 它 确实 存在 ， 因 此 它 
用 于 呈现 HTML 啊 应 。 











持 元 测试 一 一 泻 染 视 图 





要 测试 操作 方法 呈现 的 视图 ， 可 以 检查 返回 的 
ViewResult 对 象 。 这 和 检查 输出 的 视图 并 不 完全 相 
同 《〈 毕 竟 ， 你 没有 按照 过 程 检查 生成 的 最 终 
HTML) ， 但 只 要 MVC 视 图 系统 正常 工作 就 足够 
了 。 为 项 目 添 加 一 个 名 为 ActionTests.cs 的 单元 测试 





文件 ， 以 你 存 本 音 执 行 的 单元 测试 。 想 要 测试 的 第 
一 种 情况 是 当 操 作 方 法 选择 特定 的 视图 时 ， 如 下 所 


= 


GE 


public ViewResult ReceiveForm(string name, string city) 


=> View("Result", $"{name} lives in {city}"); 





可 以 通过 读 取 ViewResult 对 象 的 ViewName 属 
性 来 确定 已 选择 哪个 视图 ， 如 下 所 示 : 





using ControllersAndActions.Controllers; 
using Microsoft.AspNetCore.Mvc; 
using Xunit; 


namespace ControllersAndActions.Tests { 
public class ActionTests { 


[Fact ] 
public void ViewSelected() { 
// Arrange 
HomeController controller = new HomeControl 
ler(); 


// Act 
ViewResult result = controller.ReceiveForm( 
"Adam", "London" ); 


// Assert 
Assert.Equal("Result", result.ViewName) ; 





WE EER UA BRE TARY, BREE 
化 ， 如 下 所 示 : 


public ViewResult Result() => View(); 


在 这 种 情况 下 ， 需 要 确保 视图 名 为 null， 如 下 
所 示 : 


Assert.Null(result.ViewName); 


null 值 是 ViewResult 对 象 回 MVC 友 出 与 操作 方 
法 关联 的 默认 视图 已 被 选择 的 方式 。 


视图 的 命名 约定 方法 虽然 方便 简单 ， 但 它 限 制 
本 可 以 圣 现 的 视图 。 如 果 要 呈现 特定 的 视图 ， 可 以 
通过 提供 明确 的 路 径 并 统 过 搜索 阶段 来 实现 。 以 下 
是 一 个 通过 路 径 指 定 视 图 的 例子 。 





using Microsoft.AspNetCore.Mvc; 


namespace ControllersAndActions.Controllers { 


public class ExampleController : Controller { 


public ViewResult Index() { 
return View("/Views/Admin/Index" ) ; 





HREF RRT, PR GBA ZILA Bk ~ / FE 
涉 ， 并 且 可 以 包含 文件 扩展 名 (如 果 末 指定， 默认 
为 .cshtml) 。 


如 果 发 现 自 己 使 用 了 这 个 功能 ， 建 议 花 一 点 时 
UAT A AR SCO As. WR AS A 
AIRRA, AS oped AP E E m BAPE 
las PIERRE TIA CaS w17.5.4457 FAB) 。 
如 果 正 在 努力 解决 视图 文件 命名 方案 ， 那 么 请 参阅 
A21% 








2. 将 数据 从 操作 方法 传递 给 视图 


当 使 用 ViewResult 选 择 视图 时 ， 在 生成 HIML 
内 容 时 ， 你 可 以 通过 操作 方法 回 其 传递 要 使 用 的 数 
据 。MVC 为 操作 方法 提供 了 将 数据 传递 给 视图 的 不 
同方 式 ， 这 将 在 后 面 介 绍 。 这 些 功 能 涉及 第 21 章 中 
的 部 分 内 容 。 本 市 仅 讨 论 足 够 演示 控制 器 功能 的 视 
图 功能 。 





使 用 视图 模型 对 象 


通过 将 对 象 作 为 参数 传递 给 View 方 法 ， 你 可 以 
将 创建 的 ViewResult 对 象 传递 给 ViewData.Model 属 
性 。 之 前 的 章节 直接 设置 了 这 个 属性 来 解释 POCO 
控制 器 是 如 何 工作 的 ， 使 用 View 方 法 会 更 简洁 。 代 
人 码 清早 17-18 显 示 了 新 定义 的 ExampleController 
类 ， 将 它 添 加 到 Controllers 文件 夹 中 ， 并 将 视图 模 
型 对 象 传递 给 View 方 法 。 








代码 清单 17-18 ”Controllers 文 件 夹 下 的 ExampleController.cs 文 
件 的 内 容 
using Microsoft.AspNetCore.Mvc; 


uSing System; 
namespace ControllersAndActions.Controllers { 


public class ExampleController : Controller { 


public ViewResult Index() => View(DateTime.Now) 





以 上 代码 将 一 个 DateTime 对 象 传递 给 View 方 法 
以 用 作 视 图 模型 。 要 从 视图 内 访问 对 象 ， 可 使 用 
Razor 的 Model 关 键 字 。 创 建 Views/Example 文 件 
来， 并 添加 一 个 名 为 Index.cshtml 的 视图 文件 ， 内 容 
如 代码 清单 17-19 所 示 。 


代码 清单 17-19 ”Views/Example 文 件 夹 下 的 Index.cshtml 文 件 的 
内 容 


@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Controllers and Actions</title> 
<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 
Model: @(((DateTime)Model1) .DayOfWeek ) 
</body> 
</html> 








这 是 一 个 非 类 型 化 或 弱 类 型 的 视图 。 视 图 不 了 


解 视图 模型 对 象 的 任何 内 容 ， 并 将 其 视 为 Object 实 
例 。 为 了 获取 DayOfWeek 属 性 的 值 ， 需 要 将 对 象 强 
制 转 换 为 DateTime 实 例 ， 如 下 所 示 : 


Model: @(((DateTime)Model) .DayOfWeek ) 


虽然 这 样 页 面 可 以 正 稼 工作 ， 但 这 可 能 产生 混 
乱 。 可 以 通过 创建 强 类 型 视图 来 整理 这 一 切 ， 其 中 
的 视图 包括 视图 模型 对 象 的 类 型 细节 ， 如 代码 清单 
17-20 所 示 。 











代码 清单 17-20 ”在 Views/Example 文 件 夹 下 的 Index.cshtml 文 件 
中 添加 强 类 型 视图 








@model DateTime 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Controllers and Actions</title> 


<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 
Model: @Model .DayOfWeek 
</body> 
</html> 





这 里 使 用 Razor 的 model 天 键 字 指定 了 视图 模型 
的 类 型 。 请 注意 ， 在 指定 类 型 时 使 用 关键 字 
model， 读 取 时 使 用 关键 字 Model。 


强 类 型 不 仅 有 助 于 整理 视图 ， 而 且 Visual 
Studio 支 持 强 类 型 视图 的 智能 感知 功能 ， 如 图 17-7 
所 示 。 


ed pe ee 信 


图 17-7 强 关 型 视图 的 智能 感知 功能 





单元 测试 一 一 合 看 模型 对 象 








视图 模型 对 象 被 分 配给 
ViewResult.ViewData.Model 属 性 ， 这 意味 着 可 以 在 
使 用 View 方 法 时 测试 操作 方法 是 否 发 送 预期 的 数 
据 。 下 面 的 测试 方法 用 于 检查 代码 清单 17-20 中 的 
操作 方法 的 模型 类 型 。 
[Fact] 
public void ModelObjectType() { 
//Arrange 
ExampleController controller = new ExampleControlle 
r(); 


// Act 


ViewResult result = controller.Index(); 


// Assert 
Assert.IsType<System.DateTime>(result.ViewData.Mode 





Assert.IsType 方 法 用 于 检查 视图 模型 对 象 是 否 


是 DateTime 实 例 。 





在 使 用 View 方 法 时 ， 有 一 个 需要 注意 的 问题 : 
当 和 希望 使 用 与 菜 个 操作 关联 的 默认 视图 并 同 该 视图 
提供 字符 串 模 型 对 象 时 ， 束 会 出 现 这 种 情况 ， 如 代 
码 清单 17-21 所 示 。 











代码 清单 17-21 在 Controllers 文 件 夹 下 的 ExampleController.cs 
文件 中 使 用 View 方 法 





using Microsoft.AspNetCore.Mvc; 
using System; 


namespace ControllersAndActions.Controllers { 
public class ExampleController : Controller { 


public ViewResult Index() => View(DateTime.Now) 


public ViewResult Result() => View("Hello World 
")3 


在 新 的 Result 操 作 方 法 中 ， 作 者 硕 望 使 用 呈现 
操作 的 默认 视图 的 View 方 法 ， 并 指定 模型 数据 。 但 
是 ， 如 果 运 行 应 用 程序 并 请 求 URL 
/Example/Result， 你 将 会 看 到 类 似 下 面 的 错误 : 











InvalidOperationException: The view ‘Hello, World' was 
not found. 


The following locations were searched: 
/Views/Example/Hello, World.cshtml 
/Views/Shared/Hello, World.cshtml 
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为 “Hello,World.cshtml”* 的 视图 文件 ， 而 不 是 查找 
Result.cshtml。 只 需要 通过 将 模型 数据 强制 转换 为 
对 象 ， 就 可 以 很 容易 地 解决 这 个 问题 ， 如 代码 清单 
17-22 所 示 。 





代码 清单 17-22 ”在 Controllers 文 件 夹 下 的 ExampleController.cs 
文件 中 选择 正确 的 View 方 法 


using Microsoft.AspNetCore.Mvc; 
using System; 


namespace ControllersAndActions.Controllers { 
public class ExampleController : Controller { 


public ViewResult Index() => View(DateTime.Now) 


public ViewResult Result() => View((object)"Hel 
lo World"); 


} 





} 


将 模型 数据 显 式 转换 为 对 象 可 确保 调用 View 方 
法 的 正确 版 本 ， 并 呈现 Result.cshtml 文 件 。 


3. 通过 View Bag 传 递 数据 


第 2 章 介 绍 了 View Bag 功 能 。 此 功能 允许 定义 
动态 对 象 的 属性 ， 并 在 视图 中 访问 它们 。 通 过 
Controller 类 提供 的 ViewBag 属 性 可 访问 动态 对 象 ， 
如 代码 清单 17-23 所 示 。 





代码 清单 17-23 ”在 Controllers 文 件 夹 下 的 ExampleController.cs 


文件 中 使 用 View Bag 功 能 


using Microsoft.AspNetCore.Mvc; 
using System; 


namespace ControllersAndActions.Controllers { 


public class ExampleController : Controller { 


public ViewResult Index() { 
ViewBag.Message = "Hello"; 
ViewBag.Date = DateTime.Now; 
return View(); 


} 


public ViewResult Result() => View( (object) "Hel 
lo World"); 
} 
} 





上 和 面 通过 对 它们 进行 赋值 定义 了 名 为 Message 
和 Date 的 ViewBag 属 性 。 在 此 之 前 ， 没 有 这 样 的 属 
性 存在 ， 我 们 也 没有 做 任何 创建 它们 的 准备 。 为 了 
在 视图 中 读 取 数据 ， 需 要 获得 与 操作 方法 中 设置 的 
相同 的 属性 ， 如 代码 清单 17-24 所 示 。 





代码 清单 17-24 在 Views/Example 文 件 夹 下 的 Index.cshtml 文 件 


中 从 View Bag 中 读 取 数据 


@model DateTime 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Controllers and Actions</title> 
<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 
<p>The day is: @ViewBag.Date.DayOfWeek</p> 
<p>The message is: @ViewBag.Message</p> 
</body> 
</html> 





View Bag 相 比 使 用 视图 模型 对 象 有 一 个 优点 ， 
就 是 很 容易 将 多 个 对 象 发 送 到 视 网 。 如 果 MVC 仅 文 
持 视 图 模型 ， 那 么 需要 创建 具有 字符 串 和 DateTime 
成 员 的 新 类 型 ， 才 能 获得 相同 的 效 末 。 

















Visual Studio 无 法 为 任何 动态 对 象 〈 包 括 View 
Bag) 提供 智能 感知 文 持 ， 并 且 在 呈现 视图 之 前 不 


会 提示 错误 。 








单元 测试 





View Bag 


ViewResult.ViewData 属 性 会 返回 一 个 字典 ， 其 
关键 字 是 由 操作 方法 定义 的 ViewBag 属 性 的 名 称 。 
以 下 是 用 于 代码 清单 17-24 中 的 操作 方法 的 测试 方 


[Fact] 
public void ModelObjectType() { 
//Arrange 
ExampleController controller = new ExampleControlle 


r(); 


// Act 
ViewResult result = controller.Index(); 


// Assert 
Assert.IsType<string>(result.ViewData[ "Message" ]); 
Assert.Equal("Hello", result.ViewData[ "Message" ]); 
Assert.IsType<System.DateTime>(result.ViewData[ "Dat 
e"]); 
} 





这 个 测试 方法 使 用 Assert.IsType 方 法 检查 
Message 和 Date 属 性 的 类 型 ， 并 使 用 Assert.Equal 方 
法 检查 Message 属 性 的 值 。 


17.5.4 ”执行 章 定 问 


操作 方法 的 第 见 结果 是 不 耳 接 产生 任何 输出 ， 








而 是 将 客户 问 重 定 同 到 另 一 个 URL。 大 多 数 情况 
下 ， 这 个 URL 是 应 用 程序 中 的 为 一 个 操作 方法 ， 用 
于 生成 布 望 用 户 伍 看 的 输出 。 执 行 章 定 辣 时 ， 可 以 
器 浏览 占 发 送 以 下 两 个 HTTP 编 码 之 一 。 








。HTTP 状 态 码 302， 表 示 临 时 重 定 同 。 这 是 最 党 
用 的 重 定向 类 型 ， 当 使 用 Post/Redirect/Get 模 式 
时 ，HTTP 状 态 码 302 是 将 要 发 送 的 编码 。 

。HTTP 状 态 码 301， 表 示 永 久 重 定 同 。 应 该 谨慎 
使 用 ， 因 为 它 指 示 HTTP 状 态 码 的 收 件 人 不 要 再 
次 请 求 原 始 URL， 并 使 用 包含 在 重 定 癌 代码 劳 
边 的 新 URL。 如 有 疑问 ， 请 使 用 临时 重 定 回 
一 一 发 送 HTTP 状 态 码 302。 

















有 几 个 不 同 的 操作 结果 可 用 于 执行 重 定 同 ， 如 
表 17-9 所 示 。 


表 17-9 用 于 执行 章 定 同 的 操作 结 

















通过 HTTP 状 态 码 301 或 302 发 送别 
RedirectResult Redirect RedirectPermanent 应 ， 将 客户 端 重 定向 到 新 的 URL 














LocalRedirect 
LocalRedirectResult 准 端 重 定 问 到 本 地 URL 
LocalRedirectPermanent 











RedirectToAction 将 客户 端 重 定 向 到 特定 的 操作 和 控 


RedirectToActionResult 
RedirectionToActionPermanent | 制 器 











RedirectToRoute 将 客户 端 重 定 向 到 从 特定 路 由 生成 
RedirectToRouteResult 
RedirectToRoutePermanent 的 URL 

















1. 重 定 问 到 文本 URL 








重 定 问 浏览 器 的 最 基本 方法 是 调用 由 控制 右 类 
提供 的 重 定 同方 法 ， 人 返回 RedirectResult 类 的 一 个 实 
例 ， 如 代码 清单 17-25 所 示 。 








代码 清单 17-25 ”在 Controllers 文 件 夹 下 的 ExampleController.cs 
文件 中 重 定 癌 到 文本 URL 








using Microsoft.AspNetCore.Mvc; 
using System; 


namespace ControllersAndActions.Controllers { 


public class ExampleController : Controller { 


public ViewResult Index() { 
ViewBag.Message = "Hello"; 
ViewBag.Date = DateTime.Now; 
return View(); 


} 


public ViewResult Result() => View((object)"Hel 
lo World"); 


public RedirectResult Redirect() => Redirect("/ 
Example/Index"); 


} 


} 











重 定 同 URL 表 示 为 重 定 同 方法 的 字符 串 参 数 ， 
以 产生 临时 重 定 向 。 可 以 使 用 RedirectPermanent 方 
法 执行 永久 重 定 同 ， 如 代码 清单 17-26 所 示 。 





LocalRedirectionResult 是 可 选 的 操作 结果 。 如 
末 控 制 锋 答 试 重 定 同 到 任何 非 本 地 的 URL， 则 会 引 
发 异常 。 当 重 定 同 到 用 户 提 供 的 URL 时 ， 这 是 很 有 
用 的 。 在 这 种 情况 下 ， 重 定 同 攻击 会 将 男 一 个 用 户 
重 定 同 到 不 受信 任 的 站 点 。 此 类 操作 结果 可 以 通过 
继承 Controller 类 的 LocalRedirect 方 法 来 创建 。 








代码 清单 17-26 ”在 Controllers 文 件 夹 下 的 ExampleController.cs 
文件 中 永久 重 定 到 URL 





using Microsoft.AspNetCore.Mvc; 
using System; 


namespace ControllersAndActions.Controllers { 
public class ExampleController : Controller { 


public ViewResult Index() { 
ViewBag.Message = "Hello"; 
ViewBag.Date = DateTime.Now; 
return View(); 


} 


public ViewResult Result() => View((object)"Hel 


lo World"); 


public RedirectResult Redirect() => RedirectPer 
manent ("/Example/Index" ) ; 


} 


} 








单元 训 弃 一 一 文本 重 定 问 








文本 重 定 同 很 容易 测试 。 可 以 读 取 URL， 并 使 
用 RedirectResult 类 的 Url 和 Permanent 属 性 来 测试 重 
定 回 是 永久 的 还 是 临时 的 。 下 面 是 用 于 代码 清单 
17-26 上 所 示 的 永久 重 定 回 的 测试 方法 : 








[Fact] 
public void Redirection() { 
// Arrange 
ExampleController controller = new ExampleControlle 
r(); 
// Act 
RedirectResult result = controller.Redirect(); 
// Assert 
Assert.Equal("/Example/Index", result.Url); 
Assert.True(result.Permanent); 


... 


请 注意 ， 当 调用 操作 方法 时 ， 己 经 更 新 了 接收 
RedirectResult 的 测试 。 





2. 重 定向 到 路 由 系统 URL 








如 打 要 将 用 户 重 定 同 到 应 用 程序 的 其 他 部 分 ， 
那么 需要 确保 发 送 的 URL 在 URL 模 式 中 有 效 。 使 用 
文本 URL 进 行 章 定 问 的 问题 是 ， 路 由 模式 中 的 任何 
更 改 都 意味 着 需要 否 看 代码 并 更 新 URL。 圣 和 运 的 
是 ， 可 以 使 用 RedirectToRoute 方 法 根据 路 由 系统 生 
成 有 效 的 UREL， 该 方法 创建 了 
RedirectToRouteResult 实 例 ， 如 代码 清单 17-27 所 











人 小。 


人 


提 未 


如 采 正 在 按照 本 章 中 的 示例 顺序 执行 ， 那 么 可 
能 必须 清除 浏览 右 的 历史 记录 ， 代 码 清单 17-27 中 
的 代码 才能 正常 工作 。 这 是 因为 浏览 器 会 记 住 代码 
清单 17-26 中 的 永久 重 定 同 ， 并 将 
对 /example/Redirect 的 请 求 转换 为 对 /Example/Index 
的 请 求 ， 而 不 必 再 联系 服务 器 





代码 清单 17-27 ”在 Controllers 文 件 夹 下 的 ExampleController.cs 
文件 中 重 定 癌 到 路 由 系统 URL 








using Microsoft.AspNetCore.Mvc; 
using System; 


namespace ControllersAndActions.Controllers { 


public class ExampleController : Controller { 


public ViewResult Index() { 
ViewBag.Message = "Hello"; 
ViewBag.Date = DateTime.Now; 
return View(); 


} 


public ViewResult Result() => View((object)"Hel 
lo World"); 


public RedirectToRouteResult Redirect() => 
RedirectToRoute(new { controller = "Example 


action = "Index", 
ID = "MyID" }); 





你 可 使 用 RedirectToRoute 方法 发 出 临时 重 定 
lH], {FY RedirectToRoutePermanent 方法 进行 永久 
重 定 同 。 这 两 个 方法 都 采用 匿名 类 型 ， 属 性 然后 被 
传递 给 路 由 系统 以 生成 URL， 如 第 16 草 所 述 。 














单元 测试 一 一 路 由 重 定 问 


以 下 是 用 于 代码 清单 17-27 中 的 操作 方法 的 单 


元 测试 : 


[Fact] 
public void Redirection() { 

// Arrange 

ExampleController controller = new ExampleControlle 
r(); 

// Act 

RedirectToRouteResult result = controller.Redirect( 
)3 

// Assert 

Assert.False(result.Permanent) ; 

Assert.Equal("Example", result.RouteValues[ "control 
ler"]); 

Assert.Equal("Index", result.RouteValues["action"]); 


Assert.Equal("MyID", result.RouteValues["ID"]); 





你 可 通过 查看 RedirectToRouteResult 对 象 提供 
的 路 由 信息 来 间接 测试 结果 ， 这 意味 着 不必 人 解析 
URL， 这 将 需要 单元 测试 来 对 应 用 程序 使 用 的 URL 
模式 进行 假设 。 





3. 重 定 回 到 操作 方法 


可 以 通过 使 用 RedirectTo 操 作 方 法 (用 于 临时 
Em) 或 RedirectToActionPermanent 方 法 (用 于 
水 久 章 定 同 ) ， 更 加 优雅 地 重 定 同 到 操作 方法 。 这 
些 都 是 对 RedirectToRoute 方 法 的 包装 ， 可 以 让 你 为 
操作 方法 和 控制 右 指 定 值 ， 而 无 须 创 建 匿名 类 型 ， 
如 代码 清单 17-28 所 示 。 











代码 清单 17-28 在 Controllers 文 件 夹 下 的 ExampleController.cs 
文件 中 使 用 RedirectToAction 方 法 进行 重 定 辐 





using Microsoft.AspNetCore.Mvc; 
using System; 


namespace ControllersAndActions.Controllers { 
public class ExampleController : Controller { 


public ViewResult Index() { 
ViewBag.Message = "Hello"; 
ViewBag.Date = DateTime.Now; 
return View(); 


} 


public RedirectToActionResult Redirect() => Red 


irectToAction(nameof (Index) ) ; 
} 
} 





如 果 只 指定 一 个 操作 方法 ， 那 么 默认 是 当前 控 
制 妖 中 的 操作 方法 。 如 末 要 和 草 定 问 a 到 为 一 个 控制 
胡 ， 则 需要 提供 控制 占 的 名 称 作为 参数 ， 如 下 所 


—" 


ZN: 








public RedirectToActionResult Redirect() 


=> RedirectToAction(nameof(HomeController), nameof( 
HomeController.Index)); 





还 有 其 他 重 载 版 本 的 方法 ， 可 以 用 来 为 URL 所 
供 其 他 的 值 。 这 些 方法 使 用 匿名 类 型 ,虽然 这 样 会 
违背 使 用 这 些 方 法 的 目的 ， 但 它 可 以 使 代码 更 容易 


阅读 。 











为 操作 方法 和 控制 锅 提 供 的 值 在 传递 到 路 由 系 
统 之 前 不 会 被 验证 。 你 有 责任 确保 指定 的 目标 实际 
存在 。 





单元 测试 一 一 操作 方法 重 定 同 


以 下 是 用 于 代码 清单 17-28 中 的 操作 方法 的 单 
元 测试 : 





[Fact] 
public void Redirection() { 
// Arrange 
ExampleController controller = new ExampleControlle 


r(); 
// Act 
RedirectToActionResult result = controller.Redirect 
(); 
// Assert 
Assert.False(result.Permanent) ; 
Assert.Equal("Index", result.ActionName) ; 


} 





RedirectToActionResult 类 提供 了 
ControllerName 和 ActionName 属 性 ， 可 以 轻松 地 在 
控制 器 中 创建 重 定 同 ， 而 无 须 解 析 URL。 


4. 使 用 PosUVRedirectGet 模 式 








重 定向 经 常用 于 处 理 HTTP POST 请 求 的 操作 方 
法 。 正 如 之 前 解释 的 那样 ， 当 需要 更 改 应 用 程序 的 
状态 时 ， 会 使 用 POST 请 求 。 如 果 在 处 理 POST 请 求 
后 返回 HTML 啊 应 ， 那 么 用 户 将 有 可 能 单 击 浏览 器 
中 的 重新 加 载 按钮 并 再 次 提交 表单 ， 这 可 能 会 产生 











不 可 预料 的 结果 。 


可 以 在 示例 应 用 程序 的 Home 控 制 嚣 中 看 到 此 
问题 。ReceiveForm 方 法 会 从 表单 数据 的 参数 中 接 
收 值 ， 并 使 用 View 方 法 返回 一 个 ViewResult 对 象 : 


public ViewResult ReceiveForm(string name, string city) 


=> View("Result", $"{name} lives in {city}"); 








要 三 看 问题 ， 请 运行 应 用 程序 并 请 求 URL 
/Home。 提 交 表 单 ， 然 后 单 击 浏览 器 中 的 重新 
加 载 按钮 。 可 使 用 F12 键 来 研究 浏览 右上 友 出 的 HITP 
请 求 ， 你 将 看 到 一 个 新 的 POST 请 求 被 发 送 到 服务 
秋 。 这 在 简单 的 应 用 程序 中 没有 什么 影响 ， 但 如 采 
POST 请 求 最 终 重 复 删除 数据 ， 提 交 订 单 或 执行 用 
户 未 打算 的 其 他 重要 任务 ， 那 么 这 个 问题 可 能 会 造 
成 严重 后 采 。 











为 了 避免 这 个 问题 ， 可 以 按照 Post/Redirect/Get 
模式 进行 操作 。 在 这 种 模式 中 ， 你 将 收 到 POST 请 
KK, ASHE, PS BE tas, MEN Dia A 
一 个 URL 发 出 GET 请 求 。GET 请 求 不 应 该 修改 应 用 
程序 的 状态 ， 因 此 在 无 意 中 重 新 提交 请 求 不 会 导致 
任何 问题 。 代 码 清单 17-29 添 加 了 重 定 向 ， 以 便 浏 
览 器 被 重 定 向 到 具有 GET 请 求 的 不 同 URL。 

















代码 清单 17-29 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 使 用 Post/Redirect/Get 模 式 





using Microsoft.AspNetCore.Mvc; 
using System. Text; 
using ControllersAndActions.Infrastructure; 


namespace ControllersAndActions.Controllers { 
public class HomeController : Controller { 
public ViewResult Index() => View("SimpleForm" ) 
[HttpPost ] 
public RedirectToActionResult ReceiveForm(strin 


g name, string city) 
=> RedirectToAction(nameof (Data) ) ; 


public ViewResult Data() => View("Result") ; 





RedirectToActionResult 方 法 通过 POST 请 求 从 用 
户 接收 数据 ， 并 将 客户 端 重 定 同 到 Data 操 作 方 法 。 
如 和 用 户 重 新 加 载 页 面 ， 无 害 的 GET 请 求 将 家 及 送 
到 Data 操 作 方 法 。 第 20 章 将 介绍 使 用 HttpPost 特 性 
可 确保 只 有 POST 请 求 可 以 发 送 到 ReceiveForm 操 作 
Tits 














5. 使 用 temp 数 据 





重 定 同 将 导致 浏览 器 发 送 全 狐 的 HTTP 请 求 ， 
这 意味 看 无 法 从 原始 请 求 访问 表单 数据 ， 还 意味 看 
Data 方 法 不 知道 应 该 回 用 户 显 示 的 name 利 city 值 。 











如 果 需 要 将 数据 从 一 个 请 求 保 存 到 另 一 个 请 
求 ， 则 可 以 使 用 temp 数 据 功 能 。temp 数 据 与 第 9 章 


使 用 的 会 话 数 据 类 似 ， 只 是 在 处 理 请 求 时 ，temp 数 
据 值 在 该 取 和 删除 数据 存储 区 时 被 标记 为 删除 。 对 
于 在 Post/Redirect/Get 模 式 中 进行 章 定 癌 工 作 所 i 的 
短期 数据 ， 这 是 理想 的 安排 。temp 数 据 功 能 

名 为 TempData 的 控制 右 类 属性 获得 ， 四 - 
17-30} A o 


temp 数 据 依 赖 于 会 话 中 间 件 。 有 关 Startup 类 中 
对 应 功能 的 配置 语句 ， 可 参见 本 章 的 开始 部 分 








代码 清单 17-30 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 


件 中 使 用 temp 数 据 


using Microsoft.AspNetCore.Mvc; 

using System.Text; 

using ControllersAndActions. Infrastructure; 
namespace ControllersAndActions.Controllers { 


public class HomeController : Controller { 


public ViewResult Index() { 
return View("SimpleForm") ; 


} 


[HttpPost] 
public RedirectToActionResult ReceiveForm(strin 


g name, string city) { 
TempData["name"] = name; 
TempData["city"] = city; 
return RedirectToAction(nameof(Data)); 


} 


public ViewResult Data() { 
string name = TempData["name"] as string; 
string city = TempData["city"] as string; 
return View("Result", $"{name} lives in {ci 








ReceiveForm 方 法 使 用 TempData 属 性 获取 数据 





字典 ， 以 便 在 将 客户 端 重 定向 到 Data 操 作 方 法 之 前 
存储 name 和 city 值 。Data 操 作 方 法 使 用 相同 的 
TempData 属 性 检索 数据 值 ， 并 使 用 它们 创建 将 由 视 
图 显示 的 模型 数据 。 


p 
提示 


TempData 字 典 还 提供 了 Peek 方 法 ， 以 允许 获取 
数据 值 而 不 将 它们 标记 为 删除 。TempData 字 典 还 提 
供 了 Keep 方 法 ， 可 用 于 防止 删除 以 前 的 恋 取信 。 
Keep 方 法 不 会 永远 保护 值 。 如 果 再 次 该 取 该 值 ， 台 
会 再 次 将 其 标记 为 删除 。 请 使 用 会 话 数据 存储 值 ， 
这 样 在 处 理 请 求 时 这 些 值 才 不 会 被 删除 。 


17.5.5 返回 不 同类 型 的 内 容 


操作 方法 并 不 一 定 必 须 啊 应 为 HIML， 表 17-10 
显示 了 可 用 于 不 同类 型 数据 的 内 置 操作 结果 。 





表 17-10 操作 结 





操作 结果 
































JsonResult 将 对 象 序列 化 为 JSON 并 将 其 返回 给 客户 端 


matt em 发 送 包 含 指 定 对 象 的 响应 











ObjectResult 将 使 用 内 容 协 商 将 对 象 发 送 给 客户 端 
Available 
如 果 内 容 协商 成 功 ， 就 使 用 内 容 协商 将 HITP 对 象 发 送 给 
OkObjectResult Ok oe pa 
J shia 


如 果 内 容 协 商 成 功 ， 就 使 用 内 容 协 商 将 对 象 发 送 到 具 
HTTP 404 状 态 码 的 客户 端 












































NotFoundObjectResult | NotFound 








1. 生成 JSON 响 应 


JSON 〈JavaScript 对 象 表示 法 ) 格式 已 成 为 在 
Web 应 用 程序 及 其 客户 端 之 间 传 输 数 据 的 标准 方 
法 。 作 为 一 种 数据 交换 格式 ，JSON 在 很 大 程度 上 
取代 了 XML， 因 为 JSON 更 易于 使 用 ， 特 别 是 在 编 
写 客 户 端 JavaScript 时 ， 因 为 JSON 与 JavaScript 用 于 
定义 文本 数据 值 的 语法 密切 相关 。 第 20 章 将 介绍 
JSON 在 Web 应 用 程序 中 的 作用 ， 代 码 清单 17-31 野 
示 了 如 何 使 用 Json 方 法 创建 JgJonResult 对 象 。 











代码 清单 17-31 在 Controllers 文 件 夹 下 的 ExampleController.cs 
文件 中 生成 JSON 啊 应 





using Microsoft.AspNetCore.Mvc; 
using System; 


namespace ControllersAndActions.Controllers { 


public class ExampleController : Controller { 


public JsonResult Index() => Json(new[] { "Alic 
"Joe" }); 





运行 示例 并 请 求 URL 一 一 /Example， 你 将 看 到 
操作 方法 的 啊 应 ， 啊 应 为 JSON 格 式 的 C# 字 符 串 数 








["Alice", "Bob", "Joe" | 


大 多 数 浏览 圳 可 以 直接 显示 JSON 结 末 ， 但 在 
其 他 浏览 器 〈( 包 括 Microsoft Internet Explorer) 中 需 
要 将 数据 保存 到 文件 中 才能 但 看。 





单元 测试 一 一 非 HTML 操 作 结 


重要 的 是 要 记 住 ， 操 作 方 法 的 单元 测试 应 该 集 
中 于 返回 格式 化 的 数据 而 不 是 格式 本 里， 这 是 由 
MVC 处 理 的 ， 通 第 超出 六 多 数 测试 项 目的 范围 。 例 
如 ， 以 下 是 用 于 代码 清单 17-32 中 的 操作 方法 的 单 
元 测试 : 


[Fact] 
public void JsonActionMethod() { 


// Arrange 

ExampleController controller = new ExampleControlle 
r(); 

// Act 

JsonResult result = controller.Index(); 

// Assert 


Assert.Equal(new[] { "Alice", "Bob", "Joe" }, resul 
t.Value); 
} 





JsonResult 类 提供 了 Value 属性 ， 以 返回 将 被 转 
换 成 JSON 的 数据 ， 产 生 返 回 客户 端的 响应 。 在 单 
元 测试 中 ， 可 对 Value 属性 与 预期 的 数据 进行 比 


A o 








2. 使 用 对 象 生 成 啊 应 





许多 应 用 程序 只 需要 来 自控 制 器 的 HIML 和 
JSON 吧 应 ， 其 他 类 型 的 内 容 则 依赖 于 静态 文件 来 





传递 ， 比 如 图 像 、JavaScript 文 件 和 CSS 样 式 表 。 但 
是 ， 当 需要 在 啊 应 中 返回 特定 的 内 容 类 型 时 ， 束 十 
要 使 用 操作 结果 来 帮助 解决 这 些 问题 。 最 人 简单 的 是 
通过 Content 方 法 创建 的 ContentResult 类 ， 该 类 用 于 
发 送 珊 有 可 选 MIME 内 容 类 型 的 字符 串 值 。 在 代码 
清单 17-32 中 ， 使 用 Content 方 法 重新 创建 了 前 面 的 
JSON 结 果 。 























代码 清单 17-32 ”在 Controllers 文 件 夹 下 的 ExampleController.cs 
文件 中 手动 创建 JSON 结 果 


using Microsoft.AspNetCore.Mvc; 


namespace ControllersAndActions.Controllers { 


public class ExampleController : Controller { 


public ContentResult Index() 
=> Content ("[\"Alice\", \"Bob\",\"Joe\"]", W 
application/json") ; 





} 











当 内 容 方便 使 用 字符 串 格 式 ， 并 且 知 道 客户 站 


能 够 接收 指定 的 MIME 类 型 时 ， 这 种 类 型 的 操作 结 

末 非 第 有 用 。 这 种 方法 的 问题 在 于 不 知道 如 何 使 用 
未 知 格式 的 数据 问 客 户 问 发 送 啊 应 。 更 健壮 的 方法 
依赖 于 内 容 协 商 ， 这 是 由 ObjectResult 执 行 的 ， 如 代 
码 清单 17-33 所 示 。 





代码 清单 17-33 ”在 Controllers 文 件 夹 下 的 ExampleController.cs 
文件 中 使 用 内 容 协 商 

using Microsoft.AspNetCore.Mvc; 

namespace ControllersAndActions.Controllers { 


public class ExampleController : Controller { 


public ObjectResult Index() => Ok(new string[ ] 
{ "Alice", "Bob", "Joe" }); 





} 

内 容 协 商 构 建 了 一 种 复杂 的 系统 ， 用 于 在 浏览 
器 和 应 用 程序 之 则 找 出 共同 的 格式 。 当 浏览 右 发 出 
HTTP 请 求 时 ， 已 包括 接收 标 头 ， 用 以 指示 可 以 处 





理 的 格式 。 下 面 是 用 来 测试 示例 的 Google Chrome 
版 本 的 标 头 : 


Accept: text/html,application/xhtml+xml, application/xml 





3q=0.9, image/webp, */*;q=0.8 





支持 的 格式 已 表示 为 MIME 类 型 。MVC 有 一 组 
可 用 于 数据 值 的 格式 ， 可 与 浏览 器 支持 的 格式 做 比 
较 。MVC 使 用 的 首选 格式 是 JSON， 大 部 分 时 间 将 
使 用 这 种 格式 ， 除 非 使 用 明文 返回 字符 串 值 。 有 天 
内 容 协 商 的 过 程 及 实现 方式 的 更 多 详细 信息 ， 请 参 
见 第 20 草 。 





17.5.6” 啊 应 文件 的 内 容 


大 多 数 应 用 程序 依赖 于 静态 文件 中 间 件 传递 文 
件 的 内 容 ， 但 还 有 一 组 可 用 于 将 文件 发 送 到 客户 端 
的 操作 结果 ， 如 表 17-11 所 示 。 
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使 用 这 些 操作 结果 时 要 小 心 ， 并 确 你 不 创建 允 
许 请 求 任意 文件 内 容 的 应 用 程序 。 特 别 是 ， 不 要 从 
请 求 的 任何 部 分 或 用 户 可 以 通过 请 求 修改 的 任何 数 
据 存 储 中 获取 要 发 送 的 文件 的 路 径 。 





表 17-11 将 文件 发 送 到 客户 端的 操作 结果 


e 
ME 


AANER cio em ORCL 
从 指定 的 路 径 读 取 文 件 的 内 容 ， 并 将 内 容 发 送 给 客户 端 





代码 清单 17-34 使 用 继承 目 Controller 类 的 File 方 
法 返回 Bootstrap CSS 文 件 ， 并 作为 Example 控 制 器 
上 的 Index 操 作 方 法 的 返回 结果 。 


代码 清单 17-34 在 Controllers 文 件 夹 下 的 ExampleController.cs 
文件 中 使 用 文件 作为 啊 应 





using Microsoft.AspNetCore.Mvc; 


namespace ControllersAndActions.Controllers { 


public class ExampleController : Controller { 


public VirtualFileResult Index() 
=> File("/lib/bootstrap/dist/css/bootstrap. 
css", "text/css"); 


} 





} 


为 了 使 用 这 个 操作 方法 ， 这 里 已 经 使 用 Url 辅 
助 方法 修改 了 SimpleForm.cshtml 文 件 中 的 link 元 
素 ， 如 代码 清单 17-35 所 示 。 





代码 清单 17-35 ”在 SimplerForm.cshtml 文 件 中 指向 一 个 操作 方 
ik 


@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Controllers and Actions</title> 
<link rel="stylesheet" href="@Url.Action("Index", " 
Example")" /> 
</head> 
<body class="m-1 p-1"> 
<form method="post" asp-action="ReceiveForm" > 
<div class="form-group"> 
<label for="name">Name:</label> 
<input class="form-control" name="name" /> 
</div> 
<div class="form-group"> 
<label for="name">City:</label> 
<input class="form-control" name="city" /> 
</div> 
<button class="btn btn-primary center-block" ty 
pe="submit" >Submit</button> 
</form> 
</body> 
</html> 





如 果 运 行 示 例 并 请 求 URL 一 /Home， 则 发 送 
到 浏览 器 的 HTML 啊 应 将 包含 以 下 元 素 : 





<link rel="stylesheet" href="/Example" /> 


这 将 会 使 浏览 器 发 送 针 对 代码 清单 17-35 中 的 
操作 方法 的 HTTP 请 求 ， 进 而 发 送 在 视图 中 为 内 容 
设置 样式 所 需 的 CSS 文 件 。 


W 
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标签 助手 是 提供 CSS 的 非常 有 用 的 工具 ， 将 在 
第 25 章 中 介绍 。 


17.5.7 返回 错误 和 HTTP 状 态 人 码 


内 置 的 ActionResult 类 的 最 终 集合 (其 成 员 见 
表 17-12) 可 用 于 回 客 户 端 发 送 特定 的 错误 消息 和 





HTTP 状 态 码 。 大 多 数 应 用 程序 不 需要 这 些 功 能 ， 
因为 ASP.NET Core 和 MVC 将 自 类 型 的 
结果 。 但 是 ， 如 果 和 需要 对 发 送 给 客户 病 的 啊 应 进行 
更 直接 的 控制 ， 








表 17-12 ”内置 的 ActionResult 类 的 最 终 集合 的 成 员 























StatusCodeResult 向 客户 端 发 送 指定 的 HITP 状 态 码 
OkResult 向 客户 端 发 送 HTTP 200 状 态 码 
CreatedResult 向 客户 端 发 送 HTTP 201 状 态 码 


将 HTTP 201 状 态 码 发 送 到 客户 端 ， 并 在 
CreatedAtActionResult CreatedAtAction 


Location 标 头 中 指向 action 和 控制 器 的 URL 








将 HTTP 201 状 态 码 发 送 到 客户 端 ， 并 将 
CreatedAtRouteResult CreatedAtRoute 


URL 放 在 从 特定 路 由 生成 的 Location 标 头 中 


BadRequestResult BadRequest 向 客户 端 发 送 HTTP 400 状 态 码 
UnauthorizedResult 向 客户 端 发 送 HTTP 401 状 态 码 























NotFoundResult NotFound 向 客户 端 发 送 HTTP 404 状 态 码 





UnsupportedMediaTypeResult 向 客户 端 发 送 HTTP 415 状 态 码 


1. 发 送 特定 的 HITP 状 态 码 


AAEH StatusCode 77 YA [ay WY Wah as AIK RPE AY 
HTTP 状 态 码 ， 将 创建 一 个 StatusCodeResult 对 象 ， 
如 代码 清单 17-36 所 示 。 


代码 清单 17-36 ”在 Controllers 文 件 夹 下 的 ExampleController.cs 
文件 中 发 送 特定 的 状态 码 


using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Http; 


namespace ControllersAndActions.Controllers { 


public class ExampleController : Controller { 


public StatusCodeResult Index() 
=> StatusCode(StatusCodes.Status4@4NotFound 





StatusCode 方 法 接收 一 个 int 值 ， 可 以 使 用 它 直 
接 指定 状态 码 。Microsoft.AspNetCore.Http 命 名 空间 
中 的 StatusCodes 类 定义 了 HTTP 文 持 的 所 有 状态 码 
的 字段 。 在 以 上 代码 中 ， 已 使 用 Status404NotFound 
字段 返回 HITP 状 态 码 404， 这 表示 请 求 的 资源 不 存 
在 。 





2. 发送 404 结 果 





表 17-12 中 显示 的 其 他 操作 结 采 扩展 或 依赖 
StatusCodeResult 关 ， 该 类 提供 了 一 种 更 方便 的 发 送 
特定 状态 码 的 方法 。 可 以 使 用 更 方便 的 
NotFoundResult 关 来 实现 与 代码 清单 17-36 相 同 的 效 
果 ， 该 类 是 从 StatusCodeResult 类 派生 的 ， 可 以 使 用 
控制 器 的 NotFound 方 法 创建 ， 如 代码 清单 17-37 所 


一 


人 小。 





代码 清单 17-37 ”在 Controllers 文 件 夹 下 的 ExampleController.cs 





文件 中 生成 404 结 果 


using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Http; 


namespace ControllersAndActions.Controllers { 


public class ExampleController : Controller { 


public StatusCodeResult Index() => NotFound(); 





测试 HTTP 状 态 码 


StatusCodeResult 类 休 循 已 为 其 他 结果 类 型 使 用 
的 模式 ， 并 通过 一 组 属性 使 其 状态 可 用 。 在 这 种 情 
况 下 ，StatusCode 属 性 返回 HTTP 状 态 公 ， 
StatusDescription 属 性 返回 关联 的 摘 述 性 字符 串 。 下 
面 的 测试 方法 可 用 于 代码 清单 17-37 中 的 操作 方 
is 





[Fact] 
public void NotFoundActionMethod() { 
// Arrange 
ExampleController controller = new ExampleControlle 


r(); 


// Act 

StatusCodeResult result = controller.Index(); 
// Assert 

Assert.Equal(404, result.StatusCode) ; 








175.8 ”理解 其 他 操作 结果 类 





一 些 其 他 的 操作 结果 类 与 其 他 章节 中 摘 述 的 
MVC 功 能 紧密 相连 ， 表 17-13 列 出 了 这 些 类 。 


表 17-13 ”其 他 操作 结果 类 





描述 





























PartialViewResult 用 于 选择 分 部 视图 














ViewComponentResult | ViewComponent | 用 于 选择 视图 组 件 


EmptyResult pow Yr } 返回 客户 端的 空 响应 
























































ChallengeResult 4 求 中 强制 实施 安全 策略 


17.6 小结 





控制 器 是 MVC 设 计 模 式 中 的 关键 构件 之 一 ， 
是 MVC 开 发 的 核心 。 在 本 章 ， 你 已 经 了 解 了 如 何 使 
用 基本 的 C# 类 创建 POCO 控制 器 ， 以 及 如 何 利用 
Controller 基 类 进行 快速 开发 。 你 看 到 了 操作 结果 在 
MVC 控 制 器 中 扮演 的 角色 ， 以 及 它们 如 何 简 化 单元 
测试 。 本 章 还 展示 了 可 以 从 操作 方法 接收 输入 和 生 
成 输出 的 不 同方 式 ， 并 演示 了 内 置 的 操作 结果 。 下 
一 章 将 描述 导致 ASP.NET 开 发 人 员 困 惑 的 特性 之 
一 ， 即 依赖 注入 ， 但 它 对 于 有 效 的 MVC 开 发 古 必 不 
可 少 的 。 














第 18 半 ”依赖 注入 


本 章 将 介绍 依赖 注入 〈Dependency Injection, 
DD ， 这 征 一 种 有 助 于 灵活 创建 应 用 和 简化 单元 测 
试 的 技术 。 不 论 从 依赖 注入 有 什么 作用 看 ， 还 是 从 
依赖 注入 如 何 执行 看 ， 依 赖 注 入 都 是 一 个 很 难 理解 
的 主题 。 因 此 ， 本 章 从 传统 的 构建 应 用 程序 组 件 的 
方式 开始 ， 逐 步 解 释 依 赖 注入 的 工作 原理 及 其 重要 
性 。 表 18-1 展 示 了 在 上 下 文中 使 用 的 依赖 注入 。 


表 18-1 在 上 下 文中 使 用 的 依赖 注入 








依赖 注入 可 以 轻松 创建 松散 耦合 的 组 件 ， 这 通常 意味 着 组 件 使 用 接口 定义 的 功 
能 ， 而 不 需要 关注 功能 具体 由 哪些 类 来 实现 


































































































依赖 注入 可 以 通过 更 改 实现 了 定义 应 用 程序 功能 的 接口 的 组 件 来 更 容易 地 更 改 



































应 用 程序 的 行为 ， 还 会 导致 更 易于 隔离 单元 测试 的 组 件 

































































依赖 注 Startup 类 用 于 指定 哪些 实现 类 用 于 传递 由 应 用 程序 使 用 的 接口 指定 的 功能 。 当 
入 ? 对 象 〈《 如 控制 器 ) 创建 新 的 处 理 请 求 时 ， 将 自动 提供 它们 所 需 的 实现 类 的 实例 


























主要 的 限制 是 ， 类 将 服务 的 使 用 声明 为 构造 函数 参数 ， 这 可 能 导致 构造 函 娄 


























唯一 作用 是 接收 依赖 项 并 将 它们 分 配给 实例 字段 






































不 必 在 自己 的 代码 中 使 用 依赖 注入 ， 但 是 了 解 依赖 注入 的 工作 原理 
的 ， 因 为 MVC 使 用 依赖 注入 为 开发 人 员 提 供 功 能 


























表 18-2 展 示 了 了 本章 要 介绍 的 操作 。 


表 18-2 ”本章 要 介绍 的 操作 


代码 清单 


| 建 松散 耦合 的 组 “| 通过 接口 隔离 类 ， 并 使 用 外 部 映射 将 它们 | 代码 清单 18-9 一 代码 清单 


















































在 组 件 《〈 比 如 控制 
器 ) 中 声明 依赖 项 














类 型 的 构造 函数 参数 。 | 代码 清单 18-17 











代码 清单 18-18， 代 码 清 
单 18-20 一 代码 清单 18-26 




















配置 服务 映射 在 Startup 类 中 添加 映射 




















建 服务 接口 的 模拟 实现 ， 并 在 单元 测试 





— 





对 具有 依赖 项 的 组 | i 


























件 进 行 单元 测试 HA 








建 组 件 时 作为 构造 函数 参数 传递 。 | 代码 清单 18-19 




















指定 实现 对 象 的 创 适合 要 管理 的 服务 的 生命 周期 方法 创 | 代码 清单 18-27 一 代码 清 
R 务 映射 单 18-31 
































在 控制 器 中 接收 单 
个 操作 方法 的 依赖 È 代码 清单 18-32 
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在 控制 器 中 手动 请 
求实 现 对 象 





























J HttpContext.RequestServices J VE 代码 清单 18-33 











18.1 准备 示例 项 目 


在 本 章 中 ， 使 用 ASP.NET Core Web 
Application (.NET Core) 模板 创建 一 个 新 的 名 为 
DependencyInjection 的 Empty 项 目 。 代 码 清 单 18-1 时 
示 了 Startup 类 ， 用 于 配置 项 目的 服务 和 中 间 件 。 


代码 清单 18-1 DependencyInjection 文 件 夹 下 的 Startup.cs 文 件 
的 内 容 


uSing System; 
using System.Collections.Generic; 


using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace DependencyInjection { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 





18.1.1 创建 模型 和 存储 库 


创建 Models 文 件 夹 并 添加 一 个 名 为 Product.cs 的 
类 文件 ， 内 容 如 代码 清单 18-2 所 示 。 


代码 清单 18-2 ”Models 文 件 夹 下 的 Product.cs 文 件 的 内 容 


namespace DependencyInjection.Models { 


public class Product { 


public string Name { get; set; } 
public decimal Price { get; set; } 





为 了 管理 模型 ， 在 Models 文 件 夹 中 添加 一 个 名 
为 IRepository.cs 的 类 文件 ， 其 中 定义 的 接口 如 代码 
清单 18-3 所 示 。 





代码 清单 18-3 Models 文 件 夹 下 的 IRepository.cs 文 件 的 内 容 


using System.Collections.Generic; 
namespace DependencyInjection.Models { 
public interface IRepository { 


ITEnumerable<Product> Products { get; } 


Product this[string name] { get; } 


void AddProduct(Product product) ; 
void DeleteProduct(Product product) ; 





IRepository 接 口 定 义 了 可 对 Product 对 象 集 合 执 
行 的 操作 。 为 了 提供 这 个 接口 的 实现 ， 在 Models 文 
件 夹 中 添加 一 个 名 为 MemoryRepository.cs 的 类 文 
件 ， 内 容 如 代码 清单 18-4 所 示 。 


代码 清单 18-4 Models 文 件 严 下 的 MemoryRepository.cs 文 件 的 
内 容 





using System.Collections.Generic; 


namespace DependencyInjection.Models { 


public class MemoryRepository : IRepository { 
private Dictionary<string, Product> products; 


public MemoryRepository() { 
products = new Dictionary<string, Product>( 


) ; 
new List<Product> { 
new Product { Name = "Kayak", Price = 2 
75M }, 
new Product { Name = "Lifejacket", Pric 
e = 48.95M }, 
new Product { Name = "Soccer ball", Pri 


ce = 19.56M } 
}.ForEach(p => AddProduct(p)); 


} 


public IEnumerable<Product> Products => product 


s.Values; 


public Product this[string name] => products[na 
me]; 


public void AddProduct(Product product) => 
products[product.Name] = product; 


public void DeleteProduct(Product product) => 
products.Remove(product.Name) ; 





MemoryRepository 类 使 用 字典 将 模型 对 象 存 储 
在 内 存 中 。 这 意味 着 没有 持久 存储 ， 在 俘 止 或 重新 
局 动 应 用 程序 时 ， 会 将 模型 重 置 为 在 构造 函数 中 创 
建 的 示例 数据 对 象 。 对 于 真正 的 项 目 来 说， 这 不 是 
合理 的 方法 ， 但 用 在 这 里 很 合适 ， 本 章 的 重点 在 于 
介绍 应 用 程序 的 各 个 不 同方 面 是 如 何 工作 有 的 。 




















18.1.2 ”创建 控制 器 和 视图 


创建 Controllers 文 件 夹 ， 添 加 一 个 名 为 
HomeController.cs 的 类 文件 ， 内 容 如 代码 清单 18-5 


所 示 。 


代码 清单 18-5 “Controllers 文 件 夹 下 的 HomeController.cs 文 件 的 
内 容 


using Microsoft.AspNetCore.Mvc; 
namespace DependencyInjection.Controllers { 


public class HomeController : Controller { 


public ViewResult Index() => View(); 





Home 控 制 器 只 有 一 个 操作 方法 ， 它 使 用 View 
方法 创建 一 个 用 于 泻 染 默 认 视 图 的 ViewResult 对 
象 。 要 创建 与 操作 方法 关联 的 视图 ， 可 创建 
Views/Home 文 件 夹 ， 并 在 其 中 添加 一 个 名 为 
Index.cshtml 的 Razor 视 图 文件 ， 内 容 如 代码 清单 18- 
6 所 示 。 





代码 清单 18-6 ”Views/Home 文 件 夹 下 的 Index.cshtml 文 件 的 内 


mL 


AS 





@model IEnumerable<Product> 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Dependency Injection</title> 
<link rel="stylesheet" asp-href-include="1lib/bootst 
rap/dist/css/*.min.css" /> 
</head> 
<body class="m-1 p-1"> 
@if (ViewData.Count > @) { 
<table class="table table-bordered table-sm tab 
le-striped"> 
@foreach (var kvp in ViewData) { 
<tr><td>@kvp.Key</td><td>@kvp.Value</td 


></tr> 
} 
</table> 
} 
<table class="table table-bordered table-sm table-s 
triped"> 
<thead> 
<tr><th>Name</th><th>Price</th></tr> 
</thead> 
<tbody> 


@if (Model == null) { 
<tr><td colspan="3" class="text-center" 
>No Model Data</td></tr> 
} else { 
@foreach (var p in Model) { 
<tr> 
<td>@p.Name</td> 


<td>@string.Format("{@:C2}", p. 
Price)</td> 
</tr> 


} 
</tbody> 
</table> 
</body> 
</html> 





Index 视 图 使 用 Product 对 象 的 枚 举 进行 强 类 型 
化 ， 视 图 的 主要 内 容 是 HTML 表 格 。 如 果 控 制 器 没 
有 提供 任何 奖 型 的 数据 ， 则 会 显示 一 条 消息 作为 表 
格 的 唯一 内 容 。 如 采 存 在 模型 数据 ， 则 会 为 枚 举 中 
的 每 个 Product 对 象 问 表 中 添加 一 行 。 还 有 一 个 表 
格 ， 用 于 在 视图 中 枚 举 View Bag 的 键 和 值 〈 如 果 
View Bag 的 键 和 值 不 存在 ， 则 隐藏 这 个 表格 ) 。 











Index 视 图 依赖 于 Bootstrap CSS 包 来 为 HTML 元 
素 设置 样式 。 要 将 Bootstrap 添 加 到 项 目 中 ， 可 使 用 
Bower Configuration File 模 板 创建 bower.json 文 件 ， 
并 将 Bootstrap 软 件 包 添加 到 bower.json 的 


dependencies 部 分 ， 如 代码 清单 18-7 所 示 。 


代码 清单 18-7 ”在 DependencyInjection 文 件 夹 下 的 bower.json 文 
件 中 添加 Bootstrap 


{ 
"name": "asp.net", 
"private": true, 
"dependencies": { 
"bootstrap": "4.0.0-alpha.6" 


} 





} 


最 后 的 准备 工作 是 在 Views 文 件 夹 中 创建 
_ViewImports.cshtml 文 件 ， 访 文件 设置 了 用 于 Razor 
视图 的 内 置 标签 助手 ， 并 导入 模型 命名 空间 ， 如 代 
码 清单 18-8 所 示 。 








代码 清单 18-8 Views 文件 夹 下 的 _ViewImports.cshtml 文 件 的 内 


IP 


谷 


@using DependencyInjection.Models 
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 


18.13 ”创建 单元 测试 项 目 


按照 第 7 章 中 描述 的 步骤 ， 使 用 xUnit Test 
Project (.NET Core) 模板 创建 一 个 名 为 
DependencyInjection.Tests 的 项 目 。 这 里 删除 了 
unittest1. cs 文件 ， 因 此 项 目 中 目前 没有 任何 测试 。 
如 采 运 行 应 用 程序 ， 你 将 看 到 图 18-1 所 示 的 结 采 。 





图 18-1 运行 示例 应 用 程序 的 结果 
18.2 ”创建 松散 契合 的 组 件 


图 18-1 没 有 显示 模型 数据 的 原因 在 于 需要 将 模 
型 数据 传递 给 视图 的 HomeController 类 与 包含 模型 
数据 的 MemoryRepository 类 之 间 没 有 关系 。 在 MVC 





应 用 程序 中 ， 将 组 件 连接 在 一 起 的 目标 是 希望 能 够 
使 用 相同 功能 的 蔡 代 实现 轻松 蔡 换 组 件 。 


通过 更 换 组 件 可 以 进行 有 效 的 时 元 测试 ， 轻 松 
地 在 不 同 的 托管 环境 (如 开发 和 生产 服务 右 〉 中 更 
改 应 用 程序 的 行为 ， 并 简化 长 期 的 应 用 程序 维护 。 





接 下 来 的 几 节 将 首先 解释 侍 代 方法 及 其 带 来 的 
问题 。 这 似乎 是 解释 依赖 注入 DI) 特性 的 一 种 间 
接 方 式 ， 但 是 DI 面临 的 挑战 在 于 解决 一 些 在 编写 代 
人 码 时 不 明显 ， 但 在 开 友 周期 的 末 段 才 出 现 的 问题 。 








了 解 依赖 注入 


依赖 注入 可 能 是 一 个 难以 理解 的 话题 ，DI 是 一 
个 有 用 的 工具 ， 但 不 是 每 个 人 者 喜欢 或 需要 。 


如 果 没 有 进行 单元 测试 ， 或 者 正在 开展 小 型 、 
独立 且 稳 定 的 项 目 ，DI 将 只 能 提供 有 限 的 好 处 。 了 
解 DI 的 工作 原理 仍然 有 帮助 ， 因 为 DI 用 于 访问 某 些 
重要 的 MVC 功 能 ， 但 你 并 不 总 是 需要 在 控制 器 和 其 
他 类 中 使 用 DI。 








推荐 你 在 自己 的 项 目 中 使 用 DI， 主 要 是 因为 作 
者 发 现 项 目 经 常 出 现 一 些 意 想不到 的 问题 ， 如 果 能 
够 轻松 地 用 新 的 实现 替换 组 件 ， 就 可 以 避免 大 量 烦 
琐 上 且 容 易 出 错 的 更 改 。 











Hon E A BE Ae EY ZL 


对 于 大 多 数 开 及 人 员 来 说 ， 目 然 倾 问 是 采取 最 
直接 的 途径 来 解决 问题 。 对 于 示例 应 用 程序 来 说 ， 
这 意味 看 使 用 new 关 键 字 创建 控制 占有 所 需 的 存储 库 
对 象 ， 以 获取 模型 数据 ， 如 代码 清单 18-9 所 示 。 


代码 清单 18-9 在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 实例 化 存储 库 


using Microsoft.AspNetCore.Mvc; 
using DependencyInjection.Models; 


namespace DependencyInjection.Controllers { 


public class HomeController : Controller { 


public ViewResult Index() => View(new MemoryRep 
ository().Products) ; 


} 





} 

好 消 轧 是 ， 这 段 代码 是 有 效 的 。 如 采 运 行 应 用 
程序 ， 你 将 看 到 浏览 郁 中 显示 的 模型 对 象 的 详细 信 
恩 ， 如 图 18-2 所 示 。 


D Dependency injection x 





GO localhost:59757 R| : 
Name Price 
Kayak $275.00 
Lifejacket $48.95 


Soccer ball $19.50 


图 18-2 ”模型 对 象 的 详细 信息 


但 坏 消息 是 ，Home 控 制 器 和 
MemoryRepository 类 现在 紧密 耦合 ， 这 意味 着 无 法 
在 不 改变 HomeController 类 的 前 提 下 直接 蔡 换 存储 
库 。 正 如 第 7 章 所 解释 的 ， 执 行 有 效 的 单元 测试 意 
味 独 能 够 隔离 单个 组 件 ， 但 是 在 测试 代码 清单 18-9 
中 的 Index 操 作 方 法 时 会 隐 式 地 测试 存储 库 类 。 如 采 
单元 测试 失败 ， 将 无 法 确认 问题 出 在 控制 器 、 和 存储 
库 还 是 存储 库 依赖 的 其 他 组 件 上 。 所 以 根据 当前 实 
际 情 况 ，Home 控 制 咒 和 MemoryRepository 形 成 了 单 
独 的 单元 ， 紧 灯 合 组 件 的 影响 如 图 18-3 所 示 。 

















控制 需 


图 18-3 AAR HAF AI R 


1. K TMA E 








第 7 章 使 用 一 个 属性 ， 通 过 实现 的 接口 来 存储 





对 存储 库 类 的 引用 ， 从 而 允许 为 单元 测试 创建 模拟 
库 。 代 码 清单 18-10 显 示 了 在 本 章 的 示例 应 用 程序 
中 ， 如 何在 控制 器 中 使 用 这 种 方法 。 


代码 清单 18-10 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 使 用 Repository 属 性 


using Microsoft.AspNetCore.Mvc; 
using DependencyInjection.Models; 


namespace DependencyInjection.Controllers { 
public class HomeController : Controller { 


public IRepository Repository { get; set; } =n 
ew MemoryRepository(); 


public ViewResult Index() => View(Repository.Pr 
oducts); 





} 

如 果 要 进行 单元 测试 ， 那 么 这 种 方法 非常 适 
用 ， 因 为 可 以 通过 在 单元 测试 中 调用 操作 方法 之 前 
设置 Repository 属 性 来 隔离 控制 器 类 。 








将 一 个 名 为 DITests.cs 的 类 文件 添加 到 
DependencyInjection.Tests 项 目 中 ， 并 用 来 定义 代码 
清单 18-11 所 示 的 单元 测试 ， 从 而 使 用 Repository 属 
性 在 对 控制 器 执行 操作 之 前 设置 假 的 存储 库 。 





代码 清单 18-11 在 单元 测试 项 目 中 使 用 DITests.cs 文 件 测试 控 
制 器 





using DependencyInjection.Controllers; 
using DependencyInjection.Models; 
using Microsoft.AspNetCore.Mvc; 

using Moq; 

using Xunit; 


namespace Tests { 
public class DiTests { 


[Fact ] 
public void ControllerTest() { 
// Arrange 
var data = new[] { new Product { Name = "Te 
st", Price = 100 } }; 
var mock = new Mock<IRepository>(); 
mock.SetupGet(m => m.Products).Returns(data 


); 


ler { 


HomeController controller = new HomeControl 


Repository = mock.Object 


ie 


// Act 
ViewResult result = controller.Index() ; 


// Assert 
Assert.Equal(data, result.ViewData.Model1) ; 





Repository 属 性 允许 陋 离 控制 器 并 提供 可 以 在 
操作 方法 创建 的 ViewResult 中 检查 的 测试 数据 。 这 
仅 提 供 紧 密 硬 合 的 组 件 问题 的 部 分 解决 方案 ， 因 为 
在 应 用 程序 运行 时 无 法 设置 Repository 属 性 。 正 如 
第 17 章 所 解释 的 那样 ，MVC 人 负责 实例 化 控制 器 来 处 
理 请 求 ， 它 并 不 知道 Repository 属 性 的 特殊 重要 
性 。 访 技术 产生 的 效果 是 在 执行 单元 测试 时 控制 右 
和 存储 库 松 散 耦 合 ， 但 在 应 用 程序 运行 时 控制 器 和 
存储 库 紧 密 帮 合 ， 如 网 18-4 所 示 。 
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18-4 ”添加 Repository 属 性 后 的 效果 


2. 使 用 类 型 代理 





下 一 个 合乎 逻辑 的 步 又 是 决定 将 哪 种 存储 库 接 
口 的 实现 用 于 控制 如 类 ， 并 放 在 应 用 程序 的 其 他 位 
置 。 为 了 演示 这 是 如 何 工作 的 ， 在 示例 应 用 程序 中 
添加 Infrastructure 文 件 严 ， 并 在 其 中 琴 加 一 个 名 为 
TypeBroker.cs 的 类 文件 ， 内 容 如 代码 清单 18-12 所 
A 
代码 清单 18-12 ”Infrastructure 文件 夹 下 的 TypeBroker.cs 文 件 的 
内 容 





using DependencyInjection.Models; 
using System; 


namespace DependencyInjection.Infrastructure { 
public static class TypeBroker { 


private static Type repoType = typeof(MemoryRep 


ository); 
private static IRepository testRepo; 


public static IRepository Repository => 
testRepo ?? Activator.CreateInstance(repoTy 


pe) as IRepository; 
public static void SetRepositoryType<T>() where 


T : IRepository => 
repoType = 


public static void SetTestObject(IRepository re 


typeof (T); 


po) { 
} 


testRepo = repo; 





TypeBroker 类 定义 了 Repository 属 性 ， 并 返回 实 
现 了 IRepository 接 口 的 新 对 象 。Repository 属 性 使 用 
的 实现 类 由 repoType 字 段 的 值 确定 ， 访 字段 默认 为 
MemoryRepository， 但 可 以 通过 调用 

SetRepositoryType 方 法 进行 更 改 。 


为 了 支持 单元 测试 ，SetTestObject 方 法 允许 使 
用 特定 的 对 象 。 代 人 码 清 单 18-13 更 新 了 Home 控 制 








fits LEM AREER FA ET RR o 


代码 清单 18-13 ”在 Controllers 文 件 严 下 的 HomeController.cs 文 
件 中 使 用 类 型 代理 

using Microsoft.AspNetCore.Mvc; 

using DependencyInjection.Models; 


using DependencyInjection.Infrastructure; 


namespace DependencyInjection.Controllers { 


public class HomeController : Controller { 


public IRepository Repository { get; } = TypeBr 
oker.Repository; 


public ViewResult Index() => View(Repository.Pr 
oducts); 
} 
} 











示例 应 用 程序 中 现在 有 一 组 更 复杂 的 关系 ， 如 
图 18-5 所 示 。 需 要 注意 的 一 上 把 是 ， 控 制 占 类 和 和 存储 
ea 一 切 都 是 通过 接口 和 代 
理 来 调用 的 。 这 意味 着 可 以 更 改 仓储 库 关 ， 而 不 必 
AY LE rill ae WET EA] EL 





控制 器 | 








图 18-5 ”添加 类 型 代理 后 复杂 的 关系 


为 了 演示 类 型 代理 的 使 用 ， 在 Models 文 件 夹 中 
添加 一 个 名 为 AlternateRepository.cs 的 类 文件 ， 并 用 
来 定义 IRepository 接 口 的 另 一 个 实现 ， 如 代码 清单 
18-14 所 示 。 


代码 清单 18-14 Models 文 件 夹 下 的 AlternateRepository.cs 文 件 
的 内 容 





using System.Collections.Generic; 


namespace DependencyInjection.Models { 
public class AlternateRepository : IRepository { 
private Dictionary<string, Product> products; 


public AlternateRepository() { 
products = new Dictionary<string, Product>( 
) ; 
new List<Product> { 


new Product { Name = "Corner Flags", Pr 
ice = 34.95M }, 


new Product { Name 


"Stadium", Price = 
79500M } 


}.ForEach(p => AddProduct(p)); 


public IEnumerable<Product> Products => product 
s.Values; 


public Product this[string name] => products[na 
me]; 


public void AddProduct(Product product) => 
products[product.Name]| = product; 


public void DeleteProduct(Product product) => 
products.Remove(product.Name) ; 











在 实际 应 用 中 ， 备 用 存储 库 可 能 以 不 同 的 格式 
存储 数据 ， 或 者 使 用 不 同类 型 的 持久 化 数据 。 在 本 
例 中 ，AlternateRepository 类 和 MemoryRepository 类 
之 同 的 区 别 是 在 实例 化 类 时 创建 的 模型 数据 。 要 使 
用 AlternateRepository 类 ， 可 在 Startup 类 的 
ConfigureServices 方 法 中 配置 类 型 代理 ， 如 代码 清 
单 18-15 所 示 。 











代码 清单 18-15 “在 DependencyInjection 文 件 夹 下 的 Startup.cs 文 
件 中 配置 类 型 代理 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using DependencyInjection.Infrastructure; 

using DependencyInjection.Models; 


namespace DependencyInjection { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
TypeBroker .SetRepositoryType<AlternateRepos 


itory>(); 


services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 





可 以 通过 局 动 应 用 程序 来 查看 更 改 的 效果 ， 这 
会 显示 新 的 存储 库 类 提供 的 数据 ， 如 图 18-6 所 示 。 


DD Dependency Injection xX 
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Name Price 
Corner Flags $34.95 
Stadium $79,500.00 


图 18-6 ”更 换 存 储 库 类 


类 型 代理 允许 将 特定 对 象 用 作 存 储 库 ， 这 样 就 
可 以 像 代码 清单 18-16 那 样 编写 单元 测试 。 


代码 清单 18-16 ”使 用 测试 项 目的 DITests.cs 文 件 中 的 代理 进行 
测试 





using DependencyInjection.Controllers; 
using DependencyInjection. Infrastructure; 
using DependencyInjection.Models; 

using Microsoft.AspNetCore.Mvc; 

using Moq; 

using Xunit; 


namespace Tests { 
public class DiTests { 


[Fact ] 
public void ControllerTest() { 
// Arrange 
var data = new[] { new Product { Name = "Te 


st", Price = 100 } }; 
var mock = new Mock<IRepository>(); 
mock.SetupGet(m => m.Products).Returns(data 


TypeBroker .SetTestObject(mock.Object) ; 


HomeController controller = new HomeControl 


// Act 
ViewResult result = controller.Index(); 


// Assert 
Assert.Equal(data, result.ViewData.Mode1) ; 





18.3 ASP.NET 的 依赖 注入 


18.2 节 介绍 了 分 离 控 制 右 类 和 提供 模型 数据 的 
存储 库 的 过 程 。HomeController 类 现在 可 以 获取 
IRepository 接 口 的 实现 ， 而 不 知道 正在 使 用 哪个 类 
或 如 何 实例 化 。 有 关 Irepository 接 口 的 信息 包含 在 
TypeBroker 类 中 ， 可 由 任何 其 他 需要 访问 存储 库 的 
控制 器 使 用 ， 也 可 用 于 其 他 测试 对 象 。 














虽然 依赖 注入 可 以 构建 更 加 灵活 的 应 用 ， 但 也 
有 一 些 不 方便 的 地 方 。 最 大 的 缺点 是 开 友 人 员 必 须 
为 每 个 用 来 管理 代理 的 新 类 型 添加 新 的 方法 和 属 
性 。 可 以 重 写 TypeBroker 类 来 使 其 更 通用 ， 但 是 没 
有 任何 需要 ， 因 为 ASP.NET Core 提 供 相 同 功 能 的 版 
本 ， 并 且 更 易于 使 用 ， 不 需要 任何 其 他 的 类 。 








18.3.1 准备 依赖 注入 


依赖 注入 描述 了 创建 松散 耦合 组 件 的 另 一 种 方 
法 ， 已 被 集成 到 ASP.NET Core 平 台中 ， 由 MVC 自 
动 使 用 ， 这 意味 着 控制 器 和 其 他 组 件 不 需要 知道 如 
何 创 建 它 们 所 需 的 类 型 。 代 码 清 单 18-17 展 示 了 应 
如 何在 Home 控 制 器 中 使 用 DI。 








代码 清单 18-17 准备 在 Controllers 文 件 夹 下 的 
HomeController.cs 文 件 中 使 用 依赖 注入 





using Microsoft.AspNetCore.Mvc; 
using DependencyInjection.Models; 


using DependencyInjection.Infrastructure; 
namespace DependencyInjection.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) => repo 
Sitory = repo; 


public ViewResult Index() => View(repository.Pr 
oducts); 


} 


} 





控制 闫 将 其 依赖 项 声明 为 构造 函数 参数 。 这 是 
依赖 注入 的 第 一 部 分 ， 依 赖 注入 中 的 依赖 项 是 创建 
类 的 新 实例 所 需 的 对 象 。 在 这 种 情况 下 ， 控 制 右 类 
己 声 明 对 IRepository 接 口 的 依赖 项 。 








在 ASP.NET Core 中 ， 名 为 服务 提供 者 的 组 件 负 
贡 将 接口 映射 到 用 于 满足 依赖 关系 的 实现 类 型 。 


当 需 要 新 的 控制 器 时 ，MVC 会 要 求 服务 提供 
者 创建 一 个 新 的 HomeController 实 例 。 服 务 提 供 者 


检查 HomeController 构 造 函 数 以 确定 其 依赖 性 ， 创 
建 所 需 的 服务 对 象 ， 并 将 它们 注入 HomeController 
构造 函数 以 创建 可 用 于 处 理 请 求 的 新 控制 妖 。 
依赖 注入 的 核心 过 程 ， 所 以 再 详细 介绍 一 人 过 。 


(1) MVC 接 收 针 对 Home 控 制 器 上 的 操作 方法 
的 传 入 请 求 。 





(2) MVC 向 ASP.NET 的 服务 提供 者 组 件 请 求 
HomeController 类 的 新 实例 。 


(3) 服务 提供 者 检查 HomeController 构 造 函 
数 ， 并 发 现 它 与 IRepository 接 口 有 依赖 关系 。 


(4) 服务 提供 者 得 询 其 映射 ， 以 丛 找 已 被 告 
知 要 用 于 依赖 于 IRepository 接 口 的 实现 类 


(5) 服务 近 供 者 创建 实现 类 的 新 实例 。 


(6) 服务 提供 者 创建 一 个 新 的 HomeController 
对 象 ， 使 用 实现 对 象 作为 构造 函数 参数 。 





(7) 服务 提供 者 将 新 创建 的 HomeController 对 
象 返回 给 MVC，MVC 使 用 它 处 理 传 入 的 HTTP 请 
求 。 





整体 效 末 与 前 面 的 目 定义 类 TypeBroker 相 同 ， 
但 重要 的 优点 是 将 依赖 注入 过 程 集 成 到 了 MVC 中 ， 
这 意味 看 在 创建 控制 器 类 时 将 使 用 服务 提供 者 组 
件 。 这 允许 控制 如 类 声明 依赖 关系， 而 不 需要 知道 
如 何 解决 它们 。 你 只 需要 编写 将 其 依赖 性 声明 为 构 
造 疯 数 参 数 的 控制 右 类 ， 并 让 MVC 和 服务 提供 者 组 
件 去 完成 其 他 的 工作 。 
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本 章 的 所 有 示例 都 使 用 ASP.NET 内 置 的 依赖 注 
入 ， 它 是 ASP.NET Core 的 一 部 分 。 你 可 使 用 第 三 方 
软件 包 替 换 内 置 的 依赖 注入 ， 这 些 包 可 以 提供 一 些 
更 强 或 更 多 的 功能 。 热 门 的 包括 Autofac 和 
StructureMap 等 ， 但 在 使 用 时 需要 将 它们 集成 到 
ASP. NET Core 中 ， 你 可 以 在 GitHub 网 站 上 找到 更 
多 详细 信息 。 











18.3.2 ”配置 服务 提供 者 


如 果 运 行 示例 项 目 ， 你 会 发 现 通 过 
HomeController 构 造 函 数 声明 依赖 项 已 经 破坏 了 应 
用 程序 。 如 果 MVC 党 试 创 建 HomeController 类 的 实 
例 来 为 请 求 提供 服务 ， 束 会 过 到 图 18-7 所 示 的 错 


Ro 





图 18-7 运行 示例 项 目 出 现 的 错误 


要 解决 依赖 项 ， 必 须 配 置 服务 提供 者 ， 以 便 它 
知道 如 何 解 决 服务 依赖 和 关系。 当前 的 服务 提供 者 没 
有 这 些 信 息 ， 当 要 求 创建 HomeController 对 象 时 ， 
会 抛 出 卉 第 ， 因 为 不 知道 如 何 解决 IRepository 接 口 
上 的 依赖 天 系 。 


服务 提供 者 的 配置 是 在 Startup 类 中 定义 的 ， 
样 才能 保证 在 应 用 程序 开始 接收 请 求 之 前 服务 已 经 
准备 就 纤 。 人 代码 清 单 18-18 配 置 了 服务 提供 者 ， 从 
而 使 它 知道 如 何 处 理 IRepository 接 口上 的 依赖 关 
Re 





代码 清单 18-18 ”在 DependencyInjection 文 件 夹 下 的 Startup.cs 文 


件 中 配置 服务 提供 者 


using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using DependencyInjection. Infrastructure; 

using DependencyInjection.Models; 


namespace DependencyInjection { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 


n services) { 

services.AddTransient<IRepository, MemoryRe 
pository>(); 

services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 





依赖 注入 是 使 用 你 在 ConfigureServices 方 法 接 
收 的 IServiceCollection 对 象 上 调用 的 扩展 方法 进行 
配置 的 。 以 上 代码 中 使 用 的 AddTransient 扩 展 方法 
会 告诉 服务 提供 者 如 何 处 理 依赖 关系 《本 章 后 面 会 
详细 摘 述 ) 。 英 射 使 用 类 型 参数 表示 ， 第 一 个 类 型 


是 接口 ， 第 二 个 类 型 是 实现 类 。 





上 面 的 语句 告诉 服务 提供 者 通过 创建 一 个 





MemoryRepository 对 象 来 解析 IRepository 接 口上 的 
依赖 天 系 。 如 果 运 行 示 例 应 用 程序 ， 你 将 看 到 由 
HomeController 构 造 函 数 声明 的 依赖 项 被 解析 ， 并 
且 控 制 器 提供 了 对 模型 数据 的 访问 ， 依 赖 注 入 的 配 
置 如 图 18-8 所 示 。 





Name Price 


Kayak $275.00 
Lifejacket $48.95 
Soccer ball $19.50 


图 18-8 ”依赖 注入 的 配置 
18.3.3 ”对 具有 依赖 项 的 控制 器 进行 单元 测试 


使 用 构造 函数 接收 依赖 关系 可 以 使 控制 右 的 单 
元 测试 更 容易 。 代 码 清 单 18-19 显 示 了 代码 清单 18- 
18 中 控制 器 的 单元 测试 。 


代码 清单 18-19 在 单元 测试 项 目 中 使 用 DITests.cs 文 件 测试 控 
制 器 





using DependencyInjection.Controllers; 
using DependencyInjection.Models; 
using Microsoft.AspNetCore.Mvc; 

using Moq; 

using Xunit; 


namespace Tests { 


public class DITests { 


[Fact ] 
public void ControllerTest() { 
// Arrange 
var data = new[]| { new Product { Name = "Te 
st", Price = 100 } }; 
var mock = new Mock<IRepository>(); 
mock.SetupGet(m => m.Products).Returns(data 


) 
HomeController controller = new HomeControl 
ler(mock.Object) ; 


// Act 
ViewResult result = controller.Index(); 


// Assert 
Assert.Equal(data, result.ViewData.Model1) ; 





只 要 实现 的 接口 正确 ， 控 制 器 项 不 需要 知道 或 
关心 要 将 什么 样 的 对 象 传递 给 构造 函数 。 这 允许 使 
用 测试 用 的 存储 库 ， 而 不 必 依 赖 任何 可 能 影 啊 测试 
结果 的 外 部 类 【例如 TypeBroker 类 ) 。 


18.3.4 ”使 用 依赖 关系 链 


当 服 务 提供 者 需要 解析 依赖 天 系 时 ， 将 检 俘 已 
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是 可 以 创建 依赖 天 系 链 ， 所 有 这 些 都 是 在 运行 时 解 
析 的 ， 并 且 可 以 通过 Startup 类 中 的 配置 进行 管理 。 
为 了 演示 依赖 关系 链 ， 在 Models 文 件 夹 中 创建 一 个 
名 为 IModelStorage.cs 的 类 文件 ， 内 容 如 代码 清单 
18-20 所 示 。 








代码 清单 18-20 Models 文 件 夹 下 的 IModelStorage.cs 文 件 的 内 


IP 


谷 


using System.Collections.Generic; 
namespace DependencyInjection.Models { 


public interface IModelStorage { 


IEnumerable<Product> Items { get; } 
Product this[string key] { get; set; } 
bool ContainsKey(string key); 

void Removeltem(string key); 


} 





IModelStorage 接 口 定 义 了 人 简单 的 对 Product 对 和 象 
进行 存储 的 行为 。 为 了 实现 这 个 接口 ， 在 Models 文 


件 夹 中 添加 一 个 名 为 DictionaryStorage.cs 的 类 文 
件 ， 内 容 如 代码 清单 18-21 所 示 。 


代码 清单 18-21 Models 文 件 夹 下 的 DictionaryStorage.cs 文 件 的 
内 容 


using System.Collections.Generic; 


namespace DependencyInjection.Models { 
public class DictionaryStorage : IModelStorage { 
private Dictionary<string, Product> items 
= new Dictionary<string, Product>(); 


public Product this[string key] { 
get { return items[key]; } 
set { items[key] = value; } 

} 


public IEnumerable<Product> Items => items.Valu 
es; 


public bool ContainsKey(string key) => items.Co 
ntainsKey(key); 

public void RemoveItem(string key) => items.Rem 
ove(key); 





} 


DictionaryStorage 类 通过 使 用 强 类 型 字典 来 存 
储 模型 对 象 ， 从 而 实现 了 IModelStorage 接 口 。 这 是 





当前 包含 在 MemoryRepository 类 中 的 功能 ， 在 实际 
的 项 目 中 使 用 接口 来 分 隔 几 乎 没有 什么 价值 ， 但 它 
可 以 提供 一 个 有 用 的 示例 ， 以 说 明 如 何 使 用 依赖 注 
入 而 不 会 使 示例 应 用 程序 的 复杂 性 大 大 增加 。 








代码 清单 18-22 更 新 了 MemoryRepository 类 ， 以 
便 声 明 该 类 依赖 IModelStorage 接 口 ， 但 它 并 不 了 解 
在 实际 运行 时 使 用 的 实现 类 。 


代码 清单 18-22 ”在 Models 文 件 夹 下 的 MemoryRepository.cs 文 
件 中 声明 依赖 关系 





using System.Collections.Generic; 


namespace DependencyInjection.Models { 
public class MemoryRepository : IRepository { 
private IModelStorage storage; 


public MemoryRepository(IModelStorage modelStor 


e) { 
storage = modelStore; 
new List<Product> { 
new Product { Name = "Kayak", Price = 2 
75M }, 
new Product { Name = "Lifejacket", Pric 


e = 48.95M }, 


new Product { Name = "Soccer ball", Pri 
ce = 19.56M } 


}.ForEach(p => AddProduct(p)); 
} 


public IEnumerable<Product> Products => storage 
.Items; 


public Product this[string name] => storage[nam 
e]; 


public void AddProduct(Product product) => 
storage[product.Name] = product; 


public void DeleteProduct(Product product) => 
storage.RemoveItem(product .Name ) ; 





如 果 运 行 示 例 应 用 程序 ， 你 将 看 到 服务 提供 者 
会 提示 以 下 有 寞 音信 息 : 


InvalidOperationException: Unable to resolve service fo 
r type 


‘DependencyInjection.Models.IModelStorage' while attemp 


ting to activate 
"DependencyInjection.Models.MemoryRepository'’. 





JAAR He HE ETE KM AE. SR 
求 创建 一 个 新 的 控制 项 时 ， 服 务 提 供 者 检查 


HomeController#4J i PL, FF ACH SAAR K AR 
的 IRepository 接 口 ， 访 接口 知道 应 该 使 用 一 个 
MemoryRepository 对 象 来 解决 问题 。 服 务 提供 者 随 
后 检查 MemoryRepository 构 造 函 数 ， 访 构造 函数 依 
赖 于 IModelStorage 接 口 。 但 配置 中 没有 指定 如 何 解 
析 IModelStorage 依 赖 关 系 ， 这 意味 着 无 法 创建 
MemoryRepository 对 象 ， 反 过 来 这 意味 着 无 法 创建 
HomeController 对 象 。 所 以 服务 提供 者 无 法 同 MVC 
fe PEMD SE ag AT ia OT RP AR a o 
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何 解决 依赖 于 IModelStorage 的 依赖 关系 ， 这 里 已 经 
将 类 型 映射 添加 到 代码 清单 18-23 所 示 的 应 用 程序 
配置 中 。 


代码 清单 18-23 ”在 DependencyInjection 文 件 夹 下 的 Startup.cs 文 
件 中 配置 类 型 映射 


using System; 





using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using DependencyInjection. Infrastructure; 

using DependencyInjection.Models; 


namespace DependencyInjection { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddTransient<IRepository, MemoryRe 
pository>(); 
services.AddTransient<IModelStorage, Dictio 
naryStorage>(); 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 





通过 上 面 的 代码 ， 服 务 提供 者 可 以 满足 依赖 天 


系 链 中 的 两 个 依赖 天 系 ， 并 且 能 够 创建 服务 请 求 所 
需 的 一 组 对 象 一 一 将 注入 MemoryRepository 构 造 函 
数 的 DictionaryStorage 对 象 注 入 HomeController 构 造 
函数 。 依 赖 天 系 链 不 仅 很 智能 ， 它 们 还 允许 通过 组 
合 轻松 隔离 测试 的 组 件 来 组 合 复杂 的 功能 ， 以 及 轻 
松 地 更 改 以 适应 项 目 逐 渐 成 熟 的 不 断 变 化 的 需求 。 


18.3.5 ”对 具体 类 型 使 用 依赖 注入 





依赖 注入 也 可 以 用 于 不 能 通过 接口 访问 的 具体 
类 型 。 虽 然 这 并 没有 提供 使 用 接口 的 松散 耦合 优 
势 ， 但 它 是 十 分 有 用 的 技术 ， 因 为 允许 在 应 用 程序 
中 的 任何 地 方 访问 对 象 ， 并 将 具体 的 类 型 放 在 生命 
周期 过 理 中 ， 这 将 在 后 面 其 体 介 绍 。 


为 了 演示 ， 在 Models 文 件 夹 添加 一 个 名 为 
ProductTotalizer.cs 的 类 文件 ， 内 容 如 代码 清单 18-24 
所 示 。 


代码 清单 18-24 Models 文 件 夹 下 的 ProductTotalizer.cs 文 件 的 内 


P 


谷 


using System.Ling; 


namespace DependencyInjection.Models { 
public class ProductTotalizer { 


public ProductTotalizer(IRepository repo) => Re 
pository = repo; 


public IRepository Repository { get; set; } 


public decimal Total => Repository.Products.Sum 
(p => p.Price); 





} 


ProductTotalizer 类 没有 什么 特别 的 用 途 ， 但 它 
对 IRepository 接 口 具有 依赖 性 ， 这 意味 着 通过 使 用 
依赖 注入 ， 可 使 用 适用 于 示例 应 用 程序 的 其 余部 分 
的 配置 来 解析 依赖 天 系 。 代 码 清 单 18-25 己 将 
ProductTotalizer 类 声明 为 HomeController 类 的 依赖 
项 。 





代码 清单 18-25 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 


件 中 添加 依赖 关系 


using Microsoft.AspNetCore.Mvc; 
using DependencyInjection.Models; 
using DependencyInjection. Infrastructure; 


namespace DependencyInjection.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 
private ProductTotalizer totalizer; 


public HomeController(IRepository repo, Product 
Totalizer total) { 
repository = repo; 
totalizer = total; 


} 


public ViewResult Index() { 
ViewBag.Total = totalizer.Total; 
return View(repository.Products); 





Index 操 作 方 法 会 添加 ViewBag 属 性 ， 访 属性 包 
含 ProductTotalizer 类 生成 的 产品 总 数 ， 该 类 将 显示 
在 表格 中 ， 以 租 看 本 章 开 头 部 分 添加 到 Index.cshtml 
文件 中 的 ViewBag 值 。 最 后 一 步 是 告诉 服务 提供 者 








如 何 处 理 ProductTotalizer 请 求 ， 如 代码 清单 18-26 所 


人 小。 


代码 清单 18-26 ”在 DependencyInjection 文 件 夹 下 的 Startup.cs 文 


件 中 配置 服务 提供 者 





using 
using 
using 
using 
using 
using 
using 
using 
using 
using 


System; 

System.Collections.Generic; 

System. Ling; 

System. Threading.Tasks; 
Microsoft.AspNetCore. Builder; 
Microsoft.AspNetCore.Hosting; 
Microsoft.AspNetCore.Http; 
Microsoft.Extensions.DependencyInjection; 
DependencyInjection. Infrastructure; 
DependencyInjection.Models; 


namespace DependencyInjection { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 


n services) { 


services.AddTransient<IRepository, MemoryRe 


pository>(); 


services.AddTransient<IModelStorage, Dictio 


naryStorage>(); 


services.AddTransient<ProductTotalizer>() ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 


IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 





在 这 种 情况 下 ， 服 务 类 型 和 实现 类 型 之 间 不 存 
在 映射 ， 所 以 需要 有 AddTransient 扩 展 方法 。 讼 方 
法 接收 单个 类 型 参数 ， 访 参数 的 值 通 知 服务 提供 者 
应 将 ProductTotalizer 类 实例 化 以 解析 此 类 型 的 依赖 
项 。 


这 种 方法 的 优点 是 服务 提供 者 将 解析 任何 具体 
类 声明 的 依赖 项 ， 而 不 是 简单 地 实例 化 控制 器 中 的 
具体 类 ， 因 此 更 改 配置 以 便 使 用 专门 的 子 类 来 解析 
具体 类 的 依赖 项 。 有 具体 类 由 服务 提供 者 管理 ， 并 且 
受 生 命 周期 功能 的 控制 。 如 果 运 行 示 例 应 用 程序 ， 
你 将 看 到 模型 中 的 Product 对 象 的 总 价格 将 显示 出 
来 ， 如 图 18-9 所 示 。 
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图 18-9 ”对 类 使 用 依赖 注入 后 的 总 价格 


18.4 服务 的 生命 周期 





有 前面 使 用 AddTransient 扩 展 方法 告诉 服务 提供 
者 如 何人 处 理 IRepository 和 IModelStorage 接 口上 的 依 
赖 关 系 。AddTransient 扩 展 方法 是 可 以 定义 类 型 映 
射 的 4 种 不 同方 式 之 一 。 表 18-3 摘 述 了 用 于 告诉 服 
务 提供 者 如 何 解决 依赖 关系 的 扩展 方法 。 表 18-3 中 
的 扩展 方法 都 使 用 类 型 参数 ， 但 也 有 可 用 于 将 类 型 
对 象 作为 参数 接收 的 扩展 方法 ， 如 采 需 要 在 运行 时 
生成 映射 ， 就 可 以 使 用 这 些 扩展 方法 。 





表 18-3 服务 提供 者 的 依赖 注入 扩展 方法 


P| 





扩展 方法 描述 


























告诉 服务 提供 者 为 服务 类 型 上 的 每 个 依赖 关系 创建 实 
类 型 的 新 实例 








AddTransient<service,implType>() 



































AddTransient<service>() 于 注册 单个 类 型 (将 为 每 个 依赖 项 进行 实例 化 ) 




















AddTransient<service> 用 于 注册 将 被 调用 的 工厂 模式 ， 以 便 为 服务 类 型 的 每 个 














(factoryFunc) 依赖 项 创建 实现 对 象 




















这 些 扩展 方法 告诉 服务 提供 者 重用 实现 类 型 的 实例 ， 以 
与 公共 作用 域 关联 的 组 件 所 做 的 所 有 服务 请 求 〈 通 常 
单个 HTTP 请 求 ) 共享 同一 对 象 。 这 些 扩展 方法 遵循 
与 相应 的 AddTransient 扩 展 方法 相同 的 模式 


AddScoped<service,implType>() 









































AddScoped<service>() 








AddScoped<service>(factoryFunc) 








AddSingleton<service,implType>() 




















这 些 扩展 方法 告诉 服务 提供 者 为 第 一 个 服务 请 求 创建 实 
见 类 型 的 新 实例 ， 然 后 为 每 个 后 续 服务 请 求 重用 
































AddSingleton<service>() 











AddSingleton<service(factoryFunc) 














为 服务 提供 者 提供 可 应 用 于 服务 所 有 服务 请 求 的 对 象 ， 
服务 提供 者 将 不 会 创建 任何 新 对 象 





AddSingleton<service>(instance) 





























18.4.1 使 用 瞬 态 生命 周期 





开始 使 用 依赖 注入 的 最 简单 方法 是 使 用 
AddTransient 扩 展 方 法 ， 访 方法 告诉 服务 提供 者 在 


需要 解析 依赖 关系 时 创建 实现 类 型 的 新 实例 。 这 是 
Startup 类 中 已 经 存在 的 配置 ， 如 下 所 示 : 


public void ConfigureServices(IServiceCollection servic 


es) { 


services.AddTransient<IRepository, MemoryRepository 


>(); 


services.AddTransient<IModelStorage, DictionaryStor 
age>(); 

services.AddTransient<ProductTotalizer>() ; 

services.AddMvc(); 





表 18-3 对 生命 周期 做 了 介绍 。 瞬 态 生命 周期 会 
产生 在 每 次 解决 依赖 关系 时 创建 实现 类 的 新 实例 的 
成 本 ， 但 优点 在 于 不 必 担 心 管理 并 发 访问 或 确保 对 
象 可 以 安全 地 重用 于 多 个 请 求 。 








为 了 演示 了 瞬 态 生命 周期 ， 在 MemoryRepository 
类 中 重 写 ToString 方 法 ， 以 便 生 成 全 局 唯一 标识 符 
(GUID) ， 如 代码 清单 18-27 所 示 。 








代码 清单 18-27 重 写 Models 文 件 夹 下 的 MemoryRepository.cs 
文件 中 的 ToString 方 法 





using System.Collections.Generic; 


namespace DependencyInjection.Models { 
public class MemoryRepository : IRepository { 
private IModelStorage storage; 
private string guid = System.Guid.NewGuid().ToS 
tring(); 


public MemoryRepository(IModelStorage modelStor 


eNA 
storage = modelStore; 
new List<Product> { 
new Product { Name = "Kayak", Price = 2 
75M }, 


new Product { Name "Lifejacket", Pric 


e = 48.95M }, 


new Product { Name "Soccer ball", Pri 
ce = 19.50M } 


}.ForEach(p => AddProduct(p)); 


} 

public IEnumerable<Product> Products => storage 
. Items; 

public Product this[string name] => storage[nam 
e]; 


public void AddProduct(Product product) => 
storage[product.Name] = product; 


public void DeleteProduct(Product product) => 
storage .RemoveItem(product.Name); 


public override string ToString() { 
return guid; 





GUID 使 你 可 以 轻松 地 识别 MemoryRepository 
类 的 特定 实例 ， 并 了 解 不 同 的 生命 周期 方法 如 何 改 
变 服务 提供 者 的 行为 方式 。 代 码 清单 18-28 更 新 了 
Home 控 制 器 上 的 Index 操 作 方 法 ， 以 便 为 通过 存储 
库 设 置 为 GUID 的 View Bag 创 建 Controller 属 性 。 








代码 清单 18-28 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 使 用 View Bag 





using Microsoft.AspNetCore.Mvc; 
using DependencyInjection.Models; 
using DependencyInjection. Infrastructure; 


namespace DependencyInjection.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 
private ProductTotalizer totalizer; 


public HomeController(IRepository repo, Product 
Totalizer total) { 


repository = repo; 
totalizer = total; 


} 


public ViewResult Index() { 
ViewBag.HomeController = repository.ToStrin 


g(); 


String(); 


ViewBag.Totalizer = totalizer.Repository.To 


return View(repository.Products); 





Index 操作 方法 会 将 值 深 加 到 View Bag 中 ， 其 
中 包含 通过 ProductTotalizer 类 的 构造 函数 直接 接收 
的 repository 对 象 的 GUID， 可 以 在 运行 应 用 程序 时 
看 到 它们 。 两 个 GUID 不 同 ， D aa 己 使 
用 AddTransient 扩 展 方法 进行 了 配置 ， 这 意味 着 将 
创建 一 个 新 的 MemoryRepository 对 象 来 解决 
HomeController 的 依赖 项 和 ProductTotalizer 的 另 一 个 
属性 。 瞬 态 生 命 周 期 的 作用 如 图 18-10 所 示 。 
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图 18-10” 瞬 态 生 命 周 期 的 作用 


每 次 重新 加 载 Web 页 面 时 ， 新 的 HTTP 请 求 都 
会 导 臻 MVC 创 建 一 个 新 的 HomeController， 这 将 导 
致 创建 两 个 新 的 MemoryRepository 对 象 ， 每 一 个 都 
有 自己 的 GUID。 


cr 


fe 示 


GUID 是 唯一 的 ， 或 是 接近 唯一 的 。 因 此 ， 妆 
在 目 己 的 计算 机 上 运行 应 用 程序 时 ， 你 将 看 到 不 同 


的 值 。 


使 用 工厂 模式 


AddTransient 扩 展 方 法 的 其 中 一 个 版 本 接收 每 
次 对 服务 类 型 有 依赖 性 时 调用 的 工厂 模式 。 这 人 允许 
创建 的 对 象 及 生 变化 ， 以 便 不 同 的 依赖 项 接收 不 同 
类 型 或 实例 的 配置 。 代 码 清单 18-29 使 用 工厂 模式 
根据 应 用 程序 运行 的 答 主 环境 来 选择 IRepository 接 
口 的 不 同 实现 。 








代码 清单 18-29 在 DependencyInjection 文 件 夹 下 的 Startup.cs 文 
件 中 使 用 工厂 模式 





using System; 

using System.Collections.Generic; 
using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 
using Microsoft.AspNetCore.Hosting; 
using Microsoft.AspNetCore.Http; 


using Microsoft.Extensions.DependencyInjection; 
using DependencyInjection. Infrastructure; 
using DependencyInjection.Models; 


namespace DependencyInjection { 
public class Startup { 
private IHostingEnvironment env; 
public Startup(IHostingEnvironment hostEnv) => 
env = hostEnv; 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddTransient<IRepository>(provider 


=> { 
if (env.IsDevelopment()) { 
var X = provider.GetService<MemoryR 
epository>(); 
return x; 
} else { 


return new AlternateRepository(); 


} 
}); 


services.AddTransient<MemoryRepository>() ; 
services.AddTransient<IModelStorage, Dictio 

naryStorage>(); 
services.AddTransient<ProductTotalizer>() ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 


pe 
} 

第 14 章 描述 了 ASP.NET 如 何 为 Startup 类 提供 用 
来 帮助 设置 应 用 程序 的 服务 ， 包 括 用 于 确定 竹 主 环 
境 的 IHostingEnvironment 接 口 的 实现 。 可 以 将 这 些 
服务 作为 参数 传 给 Configure 方 法 而 不 是 
ConfigureServices 方 法 。 为 此 ， 对 Startup 类 添加 一 
个 构造 函数 ， 以 提供 对 IHostingEnvironment 对 象 的 
访问 ， 并 将 其 分 配给 一 个 名 为 env 的 字段 。 


在 ConfigureServices 方 法 中 ， 使 用 AddTransient 
扩展 方法 定义 一 个 使 用 了 Lambda 表 达 式 的 工厂 模 
式 。Lambda 表 达 式 接收 一 个 System. 
IServiceProvider 对 象 ， 该 对 象 可 用 于 创建 使 用 表 18- 
4 所 示 方 法 同 服 务 提 供 者 注册 的 其 他 类 型 的 实例 。 





表 18-4 IserviceProvider 的 方法 









































使 用 服务 提供 者 创建 服务 类 型 的 新 实例 。 如 果 请 求 的 类 型 没 
GetService<service>() 有 映射， 就 返回 null 
J 过 加 

















GetRequiredService<service> | 使 用 服务 提供 者 创建 服务 类 型 的 新 实例 。 如 果 请 求 的 类 型 没 
0 有 映射， 就 抛 出 异常 














在 工厂 模式 中 ， 使 用 IHostingEnvironment 来 确 
定 应 用 程序 是 否 在 开 友 环境 中 运行 。 如 果 在 开发 环 
境 中 运行 ， 就 使 用 GetService 方 法 创建 
MemoryRepository 类 的 实例 并 从 工厂 返回 作为 用 于 
IRepository 依 赖 项 的 对 象 的 函数 。 这 里 使 用 
GetService 方 法 创建 对 象 ， 因 为 MemoryRepository 在 
IModelStorage 接 口 sae 目 己 的 依赖 项 ， 并 使 用 服务 
提供 者 创建 对 象 ， 这 意味 看 检测 和 解决 依赖 关系 将 
目 动 进行 管理 ， 但 也 意味 着 必 须 指 定 应 用 于 
MemoryRepository 对 象 的 生命 周期 ， 如 下 所 示 : 


services.AddTransient<MemoryRepository>(); 











如 果 没 有 以 上 声明 ， 服 务 提供 者 将 不 具备 创建 
和 管理 MemoryRepository 对 象 所 需 的 信息 。 


如 有 果 应 用 程序 未 在 开 友 环境 中 运行 ， 那 么 
factory 函 数 将 返回 一 个 新 的 AlternateRepository 实 
例 。 可 以 使 用 new 关 键 字 直接 创建 ， 因 为 不 会 在 构 
et PBI NCP FS BY EA UK RK - 


18.4.2 ”使 用 作用 域 的 生命 周期 


作用 域 的 生命 周期 会 从 实现 类 创建 对 象 ， 用 于 
解决 与 单个 作用 域 关联 的 所 有 依赖 项 ， 通 常 表示 蛙 
个 HITP 请 求 “ 可 以 创建 目 己 的 作用 域 ， 但 这 在 大 
多 数 应 用 程序 中 无 效 ) 。 


由 于 默认 作用 域 是 HTTP 请 求 ， 因 此 作用 域 的 

命 周 期 允许 处 理 请 求 的 所 有 组 件 共 至 单个 对 象 ， 
并 且 在 编写 和 目 定 义 类 《如 路 由 ) 时 ， 共 享 公共 上 下 
文 数据 通常 非常 有 用 。 作 用 域 的 生命 周期 是 退 过 使 











用 AddScoped 扩 展 方法 以 配置 服务 提供 者 来 创建 
的 ， 如 代码 清单 18-30 所 示 。 


or 
提 示 


如 表 18-4 所 示 ， 还 有 其 他 接收 工厂 模式 的 
AddScoped 有 版 本 ， 可 用 于 注册 具体 类 型 。 这 些 方法 
的 工作 方式 与 前 面 演示 的 AddTransient 方 法 相同 ， 
主要 的 区 别 在 于 它们 创建 的 对 象 的 生命 周期 不 同 。 





代码 清单 18-30 在 DependencyInjection 文 件 夹 下 的 Startup.cs 文 
件 中 使 用 作用 域 的 生命 周期 


using System; 
using System.Collections.Generic; 





using System.Ling; 
using System. Threading. Tasks; 
using Microsoft.AspNetCore. Builder; 
using Microsoft.AspNetCore.Hosting; 
using Microsoft.AspNetCore.Http; 
using Microsoft.Extensions.DependencyInjection; 
using DependencyInjection. Infrastructure; 
using DependencyInjection.Models; 
namespace DependencyInjection { 
public class Startup { 
private IHostingEnvironment env; 


public Startup(IHostingEnvironment hostEnv) => 
env = hostEnv; 


public void ConfigureServices(IServiceCollectio 

n services) { 

services.AddScoped<IRepository, MemoryRepos 
itory>(); 

services.AddTransient<IModelStorage, Dictio 
naryStorage>(); 

services.AddTransient<ProductTotalizer>() ; 

services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 





在 示例 应 用 程序 中 ，HomeController 和 
ProductTotalizer 将 一 起 实例 化 以 处 理 请 求 ， 并 且 都 
要 求 存 储 库 服务 解决 IRepository 接 口上 的 依赖 关 
系 。 使 用 AddScoped 方 法 可 确保 两 个 对 象 的 依赖 项 
sauna ean eet 。 可 以 通 

运行 示例 应 用 程序 来 全 看 效果 。 浏 览 器 显示 的 两 
i 同 的 ， 如 图 aia 。 和 曹 新 加 载 页 面 
后 ， 将 创建 一 个 新 的 HTTP 请 求 ， 这 意味 着 创建 了 
一 个 新 的 MemoryRepository 对 象 。 
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图 18-11 ”作用 域 的 生命 周期 产生 的 影响 


18.4.3 ”使 用 羊 例 生命 周期 


单 例 生 命 周 期 可 确保 单个 对 象 用 于 解决 给 定 服 
务 类 型 的 所有 依赖 项 。 使 用 单 例 生命 周期 时 ， 必 须 
确保 用 于 解析 依赖 项 的 实现 类 对 于 并 发 访问 是 安全 
的 。 人 代码 清 单 18-31 更 改 了 IRepository 配 置 的 作用 
域 。 





代码 清单 18-31 ”在 DependencyInjection 文 件 夹 下 的 Startup.cs 文 
件 中 使 用 作用 域 的 生命 周期 








using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using DependencyInjection. Infrastructure; 

using DependencyInjection.Models; 


namespace DependencyInjection { 
public class Startup { 


private IHostingEnvironment env; 


public Startup(IHostingEnvironment hostEnv) => 
env = hostEnv; 


public void ConfigureServices(IServiceCollectio 


n services) { 
services.AddSingleton<IRepository, MemoryRe 
pository>(); 
services.AddTransient<IModelStorage, Dictio 
naryStorage>(); 
services.AddTransient<ProductTotalizer>() ; 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 








AddSingleton 方 法 在 第 一 次 创建 
MemoryRepository 类 的 新 实例 时 ， 必 须 在 
IRepository 接 口上 解析 依赖 项 ， 然 后 重用 到 任何 后 
续 依赖 项 ， 即 使 它们 是 不 同 的 HTTP 请求， 如 图 18- 
12 所 示 。 
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图 18-12 FE AE ais Fd BD 2 
18.5 ”使 用 操作 注入 


声明 依赖 关系 的 标准 方法 是 使 用 构造 函数 ， 这 
是 一 种 可 以 在 任何 类 中 使 用 的 技术 ， 依 赖 于 依赖 注 
入 功能 ， 依 赖 注入 功能 是 ASP.NET Core 平 台 的 一 部 


Tf 


MYVC 使 用 一 种 名 为 操作 注入 的 佬 代 方法 来 补 
充 标准 功能 ， 人 允许 通过 参数 将 依赖 天 系 声明 为 操作 
方法 。 严 格 说 来 ， 操 作 注 入 是 由 第 26 章 介绍 的 模型 
绑 定 系统 提供 的 ， 人 允许 以 不 同 的 方式 使 用 服务 。 可 


使 用 FromServices 属 性 执行 操作 注入 ， 如 代码 清单 
18-32 所 示 。 


代码 清单 18-32 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 使 用 操作 注入 


using Microsoft.AspNetCore.Mvc; 
using DependencyInjection.Models; 
using DependencyInjection. Infrastructure; 


namespace DependencyInjection.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 


} 


public ViewResult Index([FromServices]ProductTo 
talizer totalizer) { 
ViewBag.HomeController = repository.ToStrin 


g(); 


String(); 


ViewBag.Totalizer = totalizer.Repository.To 


return View(repository.Products); 








MVC 使 用 服务 提供 者 获取 ProductTotalizer 类 的 
实例 ， 并 在 调用 Index 操 作 方 法 时 将 其 作为 参数 所 
供 。 操 作 注 入 相 比 构造 函数 注入 更 不 常见 ， 但 是 ， 
当 需 要 创建 的 对 象 具有 依赖 天 系 ， 并 且 仪 在 控制 占 
定义 的 操作 方法 中 需要 时 ， 操 作 注入 会 很 有 用 。 使 
用 构造 函数 注入 可 以 解决 所 有 操作 方法 的 依赖 关 
系 ， 即 使 用 于 处 理 请 求 的 对 象 也 不 使 用 实现 目标 。 
使 用 FromServices 属 性 修饰 操作 方法 可 缩小 依赖 项 
的 焦点 ， 并 确保 只 有 在 需要 时 才 实 例 化 实现 类 型 。 





18.6 ”使 用 属性 注入 特性 


第 17 章 解释 了 如 何 通 过 声明 属性 并 使 用 
ControllerContext 来 修饰 POCO 控 制 器 中 的 上 下 文 数 
据 。 在 阅读 本 章 后 ， 你 就 会 明日 这 是 依赖 注入 的 一 
种 特殊 形式 ， 称 为 属性 注入 。 


MVC 提 供 了 一 组 专用 属性 ， 这 些 属性 可 用 于 


通过 控制 器 中 的 属性 注入 和 视图 组 件 (参见 第 22 
T) 接收 特定 类 型 。 如 果 从 控制 器 基 类 派生 控制 
器 ， 吏 不 需要 使 用 这 些 属性 ， 因 为 上 下 文 信息 是 通 
过 convenience 属 性 公开 的 ， 表 18-5 列 出 了 可 在 
POCO 控 制 费 中 使 用 的 属性 。 


表 18-5 专用 属性 


ControllerContext 提供 ActionContext 类 的 功能 超 集 


为 操作 方法 提供 上 下 文 信息 。 控 制 器 类 会 通过 ActionContext 属 性 
公开 上 下 文 信息 ， 第 31 章 将 介绍 一 组 convenience 属 性 




















ActionContext 



































rr. 
ViewComponentContext | 为 View 组 件 设置 ViewComponentContext 属 性 
ViewDataDictionary 设置 ViewDataDictionary 属 性 以 提供 对 模型 绑 定 数据 的 访问 





























18.7 手动 请 求实 现 对 象 


ASP.NET 的 依赖 注入 功能 以 及 MVC 为 属性 注 
入 和 action 注 入 提供 的 附加 属性 ， 提 供 了 为 大 多 数 
应 用 程序 创建 松散 耦合 组 件 所 需 的 所 有 文 持 。 但 是 
有 些 时 候 ， 在 不 使 用 依赖 注入 的 情况 下 获取 接口 的 
实现 也 是 有 用 的 。 在 这 些 情况 下 ， 可 以 直接 与 服务 
提供 者 一 起 工作 ， 如 代码 清单 18-33 所 示 。 








代码 清单 18-33 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 直接 使 用 服务 提供 者 





using Microsoft.AspNetCore.Mvc; 

using DependencyInjection.Models; 

using DependencyInjection. Infrastructure; 

using Microsoft.Extensions.DependencyInjection; 


namespace DependencyInjection.Controllers { 
public class HomeController : Controller { 


public ViewResult Index([FromServices ]ProductTo 
talizer totalizer) { 


IRepository repository = 
HttpContext.RequestServices.GetService< 
IRepository>(); 


ViewBag.HomeController = repository.ToStrin 


g(); 


String(); 


ViewBag.Totalizer = totalizer.Repository.To 


return View(repository.Products) ; 





由 同名 属性 返回 的 HttpContext 对 象 定 义 了 
RequestServices 方 法 ， 访 方法 返回 一 个 
IServiceProvider 对 象 ， 可 以 调用 表 18-4 中 描述 的 扩 - 
展 方法 。 以 上 代码 删除 了 使 用 属性 注入 设置 的 
Repository 属 性 ， 并 使 用 HttpContext.RequestServices 
属性 获取 IRepository 接 口 的 实现 。 这 就 是 服务 定位 
占 模 式 ， 一 些 开发 者 认为 应 该 避免 使 用 这 种 模式 。 
Mark Seemann 在 其 博客 上 详细 描述 了 这 种 模式 可 能 
导致 的 问题 。 当 通过 构造 函数 接收 依赖 天 系 的 弟 规 
技术 由 于 茶 种 原因 不 能 使 用 时 ， 以 这 种 方式 获取 服 


务 是 完全 合理 的 。 














18.8 ”小 结 


本 章 介绍 了 依赖 注入 在 MVC 应 用 程序 中 扮演 
的 角色 ， 依 赖 注入 有 助 于 创建 松散 厢 合 的 组 件 ， 以 
便 能 够 轻松 地 进行 蔡 换 和 隔离 测试 。 此 外 ， 本 章 还 
演示 了 ASP.NET 依 赖 注入 功能 和 MVC 为 将 依赖 项 
注入 属性 和 操作 方法 而 提供 的 属性 ， 介 绍 了 配置 服 
务 提 供 者 时 可 用 的 不 同 生命 周期 选项 ， 并 解释 了 它 
们 如 何 影响 对 象 的 创建 方式 。 下 一 章 将 介绍 过 滤 
人 帮 ， 它 会 在 请 求 处 理 过 程 中 添加 额外 的 逻辑 。 








第 19 章 ”过 滤 需 


ys a A I MV Cig ie XR BYE A Bb 

辑 。 它 们 提供 了 一 种 简单 而 优雅 的 方式 来 实现 区 又 
关注 。 所 谓 交 又 关注 (cross-cutting concern) ， 是 
指 可 用 于 整个 应 用 程序 ， 但 叉 不 适合 放置 在 菏 个 局 
部 位 置 的 功能 ， 否 则 会 打破 关注 点 分 离 原 则 。 典 型 
的 交叉 关注 例子 是 日 志 记 录 、 授 权 和 绥 存 。 本 章 将 
展示 MVC 文 持 的 不 同类 列 的 过 滤 磺 、 如 何 创 建 和 使 
用 目 定 义 过 尖 堪 以 及 如 何 控制 它们 的 执行 

















表 19-1 展 示 了 上 下 文中 使 用 的 过 涯 硕 。 


表 19-1 上 下 文中 使 用 的 过 滤器 














过 滤器 可 以 将 逻辑 应 用 于 操作 方法 ， 而 不 必 在 控制 器 类 中 添加 代码 























过 滤器 有 什么 “| 过 滤器 允许 应 用 不 属于 操作 的 经 典 MVC 模 式 定义 的 代码 。 可 以 实现 更 简 
作用 ? 单 的 控制 器 类 和 可 重用 的 功能 ， 并 且 可 在 整个 应 用 程序 中 应 用 















































MVC 可 通过 不 同 的 方式 使 用 不 同类 型 的 过 滤器 。 创 建 过 滤器 的 最 常见 方 
法 是 创建 一 个 类 ， 该 类 将 MVC 为 所 需 的 筛选 类 型 提供 的 属性 作为 子 类 



































过 滤器 有 什么 
陷阱 或 限制 
吗 ? 








不 同类 型 的 过 滤器 提供 的 功能 有 重 登 ， 有 时 候 很 难 选择 需要 哪 种 类 型 的 
过 滤器 











除了 过 滤器 还 
其 他 的 选择 

















没有 ， 过 滤器 是 MVC 的 核心 功能 ， 用 于 实现 日 常 所 需 的 功能 ， 比 如 用 户 
授权 




















表 19-2 展 示 了 了 本章 要 介绍 的 操作 。 


表 19-2 本章 要 介绍 的 操作 











在 请 求 处 理 中 注入 额 
外 的 逻辑 














在 控制 器 或 操作 方法 上 应 用 过 滤器 














代码 清单 19-10 
限制 对 操作 的 访问 日 授权 过 滤器 和 代码 清单 19- 


11 



































将 通用 逻辑 注入 请 求 
































使 用 操作 过 滤器 











检查 或 改变 操作 方法 
产生 的 结果 





结果 过 滤器 

















异常 过 滤器 

















在 过 滤器 























中 注册 服务 ， 并 使 
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程序 中 的 每 个 
操作 方法 应 用 过 滤器 




















更 改 执行 过 滤器 的 顺 
序 





月 Order 参 数 


19.1 准备 示例 项 目 





声明 过 滤器 构造 函数 中 的 依赖 关系 ， 在 Startup 类 





应 用 过 滤器 





| TypeFilter} 14 








依赖 注入 的 生命 周期 在 Startup 类 中 注册 过 滤 


ServiceFilter 属 性 应 用 过 滤器 





代码 清单 19-12 
一 代码 清单 19- 
14 











代码 清单 19-15 
一 代码 清单 19- 
19 





代码 清单 19-20 
和 代码 清单 19- 
21 











代码 清单 19-22 
一 代码 清单 19- 
26 








代码 清单 19-27 
一 代码 清单 19- 
29 











代码 清单 19-30 
一 代码 清单 19- 
32 











代码 清单 19-33 
一 代码 清单 19- 
36 











在 本 章 中 ， 将 苯 循 前 儿童 使 用 的 相同 方法 来 创 
建 示 例 应 用 程序 。 使 用 ASP.NET Core Web 
Application (.NET Core) 模板 创建 一 个 名 为 Filters 
的 Empty 项 目 。 人 代码 清单 19-1 显 示 了 对 Startup 类 所 
做 的 更 改 ， 用 于 局 用 MVC 框 架 和 开发 所 需 的 其 他 中 
间 件 。 





代码 清单 19-1 Filters 文 件 夹 下 的 Startup.cs 文 件 的 内 容 





uSing System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace Filters { 
public class Startup { 
public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 
} 
public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages() ; 
app.UseDeveloperExceptionPage() ; 


app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 





19.1.1 启用 SSL 





本 章 中 的 一 些 示例 需要 使 用 SSL， 默 认 情 况 下 
SSL 是 禁用 的 。 要 启用 SSL， 请 从 Visual Studio 菜 单 
中 选择 Filter Properties， 然 后 在 Debug 选 项 卡 中 勾 
选 “Enable SSL https:Wlocalhost:44318/” 复 选 枉 ， 如 
图 19-1 所 示 。 请 注意 记录 分 配 的 端口 ， 这 对 于 每 个 
项 目 将 是 不 同 的 。 








图 19-1 启用 SSL 


19.1.2 ”创建 控制 器 和 视图 








本 章 中 的 控制 右 很 简单 ， 因 为 本 章 的 重点 是 应 
用 程序 的 其 他 位 置 。 这 里 创建 Controllers 文 件 夹 ， 
添加 一 个 名 为 HomeController.cs 的 类 文件 ， 内 容 如 
代码 清单 19-2 所 示 。 


代码 清单 19-2 ”Controllers 文 件 夹 下 的 HomeController.cs 文 件 的 
内 容 


using Microsoft.AspNetCore.Mvc; 
namespace Filters.Controllers { 


public class HomeController : Controller { 


public ViewResult Index() => View("Message", 
"This is the Index action on the Home contr 


oller"); 
} 
} 








Index 操 作 方 法 将 呈现 一 个 名 为 Message 的 视 
图 ， 并 将 一 个 字符 串 传 递 给 该 视图 。 这 里 创建 
Views/Shared 文 件 严 ， 并 添加 一 个 名 为 
Message.cshtml 的 Razor 视 图 文件 ， 内 容 如 代码 清单 


19-3 所 示 o 


代码 清单 19-3 Views/Shared 文 件 夹 下 的 Message.cshtml 文 件 的 
内 容 





@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Filters</title> 
<link asp-href-include="1lib/bootstrap/dist/css/*.mi 
n.css" rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
@if (Model is string) { 
@Model 
} else if (Model is IDictionary<string, string>) { 
var dict = Model as IDictionary<string, string> 
<table class="table table-sm table-striped tabl 
e-bordered"> 
<thead><tr><th>Name</th><th>Value</th></tr> 
</thead> 
<tbody> 
@foreach (var kvp in dict) { 
<tr><td>@kvp.Key</td><td>@kvp. Value 
</td></tr> 


} 
</tbody> 


</table> 


} 
</body> 
</html> 











Message 视 图 是 弱 类 型 视图 ， 将 显示 字符 串 或 
字典 Dictionary<string,string>， 在 当前 情况 下 ， 会 显 
示 一 个 表格 。 


Message 视 图 依赖 于 Bootstrap CSS 包 来 为 HTML 
元 素 设置 样式 。 要 将 Bootstrap 包 添加 到 项 目 中 ， 可 
以 使 用 Bower Configuration File 模 板 ， 在 项 目的 根 
文件 夹 中 创建 bower.json 文 件 ， 并 将 Bootstrap 包 添 
加 到 dependencies 部 分 ， 如 代码 清单 19-4 所 示 。 





代码 清单 19-4 在 Filters 文 件 夹 下 的 bower.json 文 件 中 添加 
Bootstrap 包 中 





{ 
"name": "asp.net", 
"private": true, 
"dependencies": { 
"bootstrap": "4.0.0-alpha.6" 
} 


最 后 的 准备 工作 是 在 Views 文 件 夹 中 创建 
_ViewImports.cshtml 文 件 ， 用 于 设置 内 置 的 标 俭 助 


一 


小 。 


代码 清单 19-5” ”Views 文件 夹 下 的 _ViewImports.cshtml 文 件 的 内 


mL 


4S 


@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 


如 果 运 行 示例 应 用 程序 ， 看 到 的 输出 将 如 图 
19-2 上 所 示 。 





图 19-2 ”运行 示例 应 用 程序 的 输出 


人 


fe 未 


系统 可 能 会 提示 需要 信任 Visual Studio 生 成 的 
证 书 。 请 接受 建议 ， 这 与 本 章 中 的 示例 依赖 于 SSL 
AK 


19.2 (AWE 


TYE as IA VFM FE tll a PR EER VE 7 iE R H 
Hews, FER A PE. PN, Mik 
设 要 确保 只 能 使 用 HTTPS 访问 操作 方法 ， 而 不 能 
使 用 常规 的 未 加 密 HITTP。HttpRequest 上 下 文 对 象 
提供 了 是 否 使 用 HTTPS 的 信息 ， 如 代码 清单 19-6 所 


人 小。 





代码 清单 19-6 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 验证 是 否 使 用 HTTPS 


using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Http; 


namespace Filters.Controllers { 
public class HomeController : Controller { 


public IActionResult Index() { 
if (!Request.IsHttps) { 
return new StatusCodeResult(StatusCodes 
. Status403Forbidden) ; 
} else { 
return View("Message", 
"This is the Index action on the Ho 


me controller"); 











RAN S TERA EYE AS A To BE 
HTTPS H. WRIST AN PIV AEP Da 
求 Index 操 作 方 法 并 处 理 不 带 HITPS 的 默认 URL， 
还 会 返回 一 个 StatusCodeResult， 用 以 在 啊 应 中 发 送 
HTTP 403 状 态 编码 〈 如 第 17 章 所 述 ) 。 如 果 要 求 带 








HTTPS 的 默认 URL (比如 https://localhost:44318) ， 
Index 操 作 方 法 将 通过 泻 染 Message 视 图 进行 啊 应 
( er 响 器 显示 结果 之 前 确认 安全 警 
。 图 19-3 显 示 了 这 两 种 结 来 。 








| This is the Index action on the Home controller 


图 19-3 ”限制 对 HTTPS 请 求 的 访问 的 结果 


cr 


提 ZN 


如 果 没 有 从 示例 中 获得 期 望 的 结果 ， 请 清除 浏 
览 器 的 历史 记录 。 浏 览 器 通常 和 
SSL 错 误 的 服务 器 发 送 请 求 ， 这 是 很 好 的 安全 设 





置 ， 但 在 开发 过 程 中 可 能 不 是 很 方便 。 


代码 清单 19-6 中 的 代码 可 以 正常 工作 ， 但 也 存 
在 一 些 问题 。 其 中 一 个 问题 是 ， 操 作 方 法 包含 的 代 
码 更 多 的 是 实现 安全 策略 ， 而 不 是 处 理 请 求 、 更 新 
模型 和 选择 响应 。 男 一 个 更 严重 的 问题 是 ， 在 操作 
方法 中 包括 的 HITP 检 测 代 码 不 能 很 好 地 进行 扩 
展 ， 并 且 必 须 在 控制 器 中 的 每 个 操作 方法 中 重复 ， 
如 代码 清单 19-7 所 示 。 

















代码 清单 19-7 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 添加 一 个 操作 方法 





using Microsoft.AspNetCore.Http; 
using Microsoft.AspNetCore.Mvc; 


namespace Filters.Controllers { 
public class HomeController : Controller { 


public IActionResult Index() { 


if (!Request.IsHttps) { 
return new StatusCodeResult(StatusCodes 
. Status403Forbidden) ; 
} else { 
return View("Message", 
"This is the Index action on the Ho 
me controller"); 
} 
} 


public IActionResult SecondAction() { 
if (!Request.IsHttps) { 
return new StatusCodeResult(StatusCodes 
. Status403Forbidden) ; 
} else { 
return View("Message", 
"This is the SecondAction action on 
the Home controller"); 





必须 记 住 ， 在 每 个 需要 HTTPS 的 控制 器 的 每 个 
操作 方法 中 都 要 执行 相同 的 检查 。 实 现 安 全 策略 的 
代码 是 控制 器 的 重要 组 成 部 分 ， 虽 然 看 起 来 实现 很 
简单 ， 但 会 使 控制 器 更 难 理解 ， 忘 记 将 它们 添加 到 
新 的 操作 方法 中 只 是 时 间 问 题 ， 这 是 安全 漏洞 。 这 
个 问题 可 以 通过 使 用 过 滤器 来 解决 ， 如 代码 清单 




















19-8 所 示 o 


代码 清单 19-8 在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 使 用 过 滤器 


using Microsoft.AspNetCore.Http; 
using Microsoft.AspNetCore.Mvc; 


namespace Filters.Controllers { 


public class HomeController : Controller { 


[RequireHttps ] 
public ViewResult Index() => View("Message", 
"This is the Index action on the Home contr 
oller"); 


[RequireHttps ] 
public ViewResult SecondAction() => View("Messa 


"This is the SecondAction action on the Hom 
e controller"); 


} 





} 


RequireHttps H HERK — A A E DE as DF 
于 HomeController 类 。 这 将 限制 对 操作 方法 的 访 
问 ， 仪 支持 HTTPS 请 求 ， 并 允许 从 每 个 方法 中 删除 


安全 代码 ， 使 方法 可 以 专注 于 处 理 成 功 接收 到 的 请 


We 
v2 Ee 
vk Ja 


RequireHttps 过 小 占 的 工作 方式 与 代码 清单 19-7 
中 的 目 定义 代码 完全 相同 。 对 于 GET 请 求 ， 
RequireHttps 特 性 将 客户 端 重 定 辣 到 原始 请 求 的 
URL， 但 是 要 求 通 过 使 用 HTTPS 方 案 来 执行 操作 ， 
此 对 http://localhost/Home/Index 的 请 求 会 被 重 定 问 
到 Jhttps://localhost/Home/Index。 这 对 于 部 署 的 大 多 
数 应 用 程序 来 说 是 有 音义 的 ， 但 在 开 友 过 程 中 不 是 
这 样 ， 因 为 HTTP 和 HTTPS 使 用 的 是 不 同 的 端口 。 
RequireHttpsAttribute 类 定义 了 一 个 名 为 

















HandleNonHttpsRequest 的 受 保 护 方 法 ， 可 以 重 写 议 
方法 以 更 改 其 行为 。 也 可 参考 19.4 节 ， 从 头 开 始 创 
建 原 始 的 功能 。 


当然 ， 还 需要 将 RequireHttps 特 性 应 用 到 每 个 
操作 方法 ， 有 了 时候 你 可 能 会 忘记 这 件 事 。 但 是 过 洲 
器 有 如 下 很 有 用 的 技巧 : 将 特性 应 用 于 控制 器 类 与 
将 特性 应 用 于 每 个 单独 的 操作 方法 具有 相同 的 效 
朱 ， 如 代码 清单 19-9 所 示 。 





代码 清单 19-9 ”将 过 滤器 应 用 于 HomeController.cs 文 件 中 的 所 
有 操作 方法 





using Microsoft.AspNetCore.Http; 
using Microsoft.AspNetCore.Mvc; 


namespace Filters.Controllers { 


[RequireHttps ] 
public class HomeController : Controller { 


public ViewResult Index() => View("Message", 
"This is the Index action on the Home contr 
oller"); 


public ViewResult SecondAction() => View("Messa 
ge", 
"This is the SecondAction action on the Hom 
e controller"); 


} 


} 





TERADE. UR ERR all Wy o Fe EE BR 
作 而 不 影响 其 他 操作 ， 可 以 将 RequireHttps 特 性 应 
用 于 这 些 方法 。 如 采 要 保护 所 有 操作 方法 ， 包 括 未 
来 添加 到 控制 器 中 的 任何 操作 ， 那 么 可 以 将 
RedquireHttps 特 性 应 用 于 控制 器 类 。 如 果 要 对 应 用 
程序 中 的 每 个 操作 应 用 过 小 器， 可 以 使 用 全 局 过 小 
器 ， 这 将 在 本 章 后 面 进行 介绍 。 





19.3 ”实现 过 滤器 


你 已 经 看 到 如 何 使 用 过 滤器 ， 现 在 介绍 过 滤器 
在 幕后 是 如 何 实现 的 。 过 滤器 实现 了 IFilterMetadata 











接口 ， 该 接口 定义 在 
Microsoft.AspNetCore.Mvc.Filters 命 名 空间 中 : 
namespace Microsoft.AspNetCore.Mvc.Filters { 


public interface IFilterMetadata { } 
} 





该 接口 是 空 的 ， 不 需要 过 滤器 类 来 实现 任何 特 
定 的 行为 。 这 是 因为 有 几 种 不 同类 型 的 过 滤器 ， 它 
们 的 工作 方式 各 不 相同 ， 并 用 于 不 同 的 目的 。 











表 19-3 列 出 了 各 种 类 型 的 过 滤器 、 定 义 它 们 的 
接口 以 及 它们 所 做 的 事情 (MVC 还 文 持 一 些 其 他 类 
型 的 过 滤器， 但 它们 不 是 直接 使 用 的 ， 而 是 集成 到 
功能 中 ， 并 通过 特定 属性 进行 应 用 ， 包 括 第 20 章 将 
要 介绍 的 Produces 和 Consumes 属 性 。) 








表 19-3 不 同类 型 的 过 滤器 





















































授权 过 滤 |IAuthorizationFilter 使 用 应 用 程序 的 安全 策略 ， 包 括 用 户 授权 
器 IAsyncAuthorizationFilter 





IActionFilter 





在 执行 操作 方法 之 前 或 之 后 立即 执行 工作 
TAsyncActionFilter 

















TResultFilter 在 处 理 操作 方法 的 结果 之 前 或 之 后 立即 执行 工 


IAsyncResultFilter 作 


IExceptionFilter 





TAsyncExceptionFilter 





2219-3 FIN FIA AER, § TAA AE a te 
独 进 行 很 多 工作 ， 仪 受 想 象 力 和 和 十 要 解决 的 问题 的 
限制 。 如 果 你 了 解 过 小强 是 如 何 工作 的 ， 这 将 变 得 
更 清楚 ， 现 在 有 两 个 要 扣 需 要 理解 。 








自 先 ， 表 19-3 中 的 每 种 类 型 的 过 小 颖 都 有 两 种 
不 同 的 接口 。 过 泪 器 可 以 同步 或 异步 地 执行 它们 的 
工作 ， 比 如 ， 同 步 实现 的 过 涯 需 实 现 了 IResultFilter 
fe, MRAP SCHL as NU SCHL S 
TAsyncResultFilter## H « 


其 次 ， 过 滤器 按 特定 的 顺序 执行 。 首 先 执行 授 
权 过 滤器 ， 然 后 执行 文件 操作 ， 接 下 来 执行 结果 过 
滤器 。 只 有 抛 出 异常 才 会 执行 异常 过 滤器 ， 这 会 打 
乱 正常 的 执行 序列 。 


获取 上 下 文 数据 





过 涯 器 以 FilterContext 对 象 的 形式 提供 上 下 文 
数据 。FilterContext 类 派生 目 ActionContext， 
ActionContext 也 是 第 17 音 描述 的 ControllerContext 类 
的 基 类 。 为 方便 起 见 ， 表 19-4 列 出 了 从 
ActionContext 类 继承 的 属性 以 及 FilterContext 定 义 的 
附加 属性 。 


表 19-4 ”FilterContext 类 的 属性 























ActionDescriptor | 返回 一 个 ActionDescriptor 对 象 ， 该 对 象 描述 了 操作 方法 














回 一 个 HttpContext 对 象 ， 该 对 象 提供 HTTP 请 求 的 详细 信息 以 及 将 要 作 
为 回复 发 送 的 HTTP 响应 





























返回 一 个 ModelStateDictionary 对 象 ， 用 于 验证 客户 端 发 送 的 数据 











返回 一 个 RouteData 对 象 ， 描 述 路 由 系统 处 理 请 求 的 方式 

































































立 用 于 操作 方法 的 过 滤器 列表 ， 表 示 为 IList <IFilterMetadata> 











19.4 EA BAS as 


PAI YE 4s FS J SEEDS EP 2H. PE 
权 过 滤器 在 其 他 类 型 的 过 小 器 之 前 和 执行 操作 方法 
之 前 执行 。 以 下 是 IAuthorizationFilter 接 口 的 定义 : 


namespace Microsoft.AspNetCore.Mvc.Filters { 


public interface IAuthorizationFilter : IFilterMeta 
data { 


void OnAuthorization(AuthorizationFilterContext 
context) ; 


} 





} 


可 调用 OnAuthorization 方 法 来 为 过 滤器 提供 好 





证 授权 请 求 。 对 于 异步 授权 过 小 费 ， 以 下 十 
IAsyncAuthorizationFilter 接 口 的 定义 : 


using System.Threading.TasKs ; 


namespace Microsoft.AspNetCore.Mvc.Filters { 


public interface IAsyncAuthorizationFilter : IFilte 
rMetadata { 


Task OnAuthorizationAsync(AuthorizationFilterCo 
ntext context) ; 


} 





} 


调用 OnAuthorizationAsync 方 法 ， 以 便 过 滤器 
可 以 授权 请 求 。 无 论 使 用 哪个 接口 ， 过 滤器 都 会 通 
过 AuthorizationFilterContext 对 象 〈 从 FilterContext 类 
派生 ) 接收 摘 述 请 求 的 上 下 文 数 据 ， 并 添加 一 个 重 
要 属性 一 一 Result， 如 表 19-5 所 示 。 





表 19-5 ”AuthorizationFilterContext 类 的 属性 









































Result | 当 请 求 不 符合 应 用 程序 的 授权 策略 时 ，IActionResult 属 性 由 授权 过 滤器 设置 ， 如 果 



































设置 了 这 个 属性 ，MVC 将 会 呈现 IActionResult 而 不 是 调用 操作 方法 
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N TERZLER VE RE, FEN II H 
HF il) Infrastructure LE, FAMNEN 
HttpsOnlyAttribute.cs 的 类 文件 〈 见 代码 清单 19- 
10) , ene CUE aR o 


代码 清单 19-10 ”Infrastructure 文件 夹 下 的 HttpsOnlyAttribute.cs 
文件 的 内 容 





uSing System; 
using Microsoft.AspNetCore.Http; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.Filters; 
namespace Filters.Infrastructure { 
public class HttpsOnlyAttribute : Attribute, IAutho 
rizationFilter { 


public void OnAuthorization(AuthorizationFilter 
Context context) { 
if (!context.HttpContext.Request.IsHttps) { 
context.Result = 
new StatusCodeResult(StatusCodes.St 
atus4@3Forbidden) ; 


如 果 请 求 符合 授权 策略 ， 则 授权 过 滤器 不 执行 
任何 操作 ，MVC 会 进入 下 一 个 过 滤器 ， 最 后 执行 操 
1 


E 


va ae 
YE 友 





在 之 前 的 MVC 中 ， 可 以 用 于 限制 特定 用 户 和 
用 户 组 访问 的 Authorize 属 性 是 使 用 过 小 器 实现 的 ， 
但 ASP.NET Core MVC 中 不 再 是 这 样 。Authorize 属 
性 仍然 全 用 ; (ACPA SAAT. fea, ee 
器 〈 本 章 后 面 将 介绍 全 局 过 滤器 ) 用 于 检测 
Authorize 属 性 并 执行 ASP.NET Core Identity 系 统 定 





义 的 策略 ， 但 Authorize 属 性 不 再 是 过 滤器 ， 不 能 实 
现 IAuthorizationFilter 接 口 。 第 29 章 将 介绍 如 何 使 用 
ASP.NET Core Identity 系 统 和 Authorize 属 性 。 


如 果 存 在 问题 ， 则 过 小 右 会 设置 传递 给 
OnAuthorization 方 法 的 AuthorizationFilterContext 对 
象 的 Result 属 性 。 这 可 以 阻止 事件 的 进一步 执行 ， 
并 为 MVC 提 供 返 回 到 客户 端的 结果 。 在 以 上 代码 
中 ，HttpsOnlyAttribute 类 检查 HttpRequest Context 对 
象 的 IsHttps 属 性 ， 并 将 Result 属 性 设置 为 在 没有 
HTTPS 的 情况 下 发 出 请 求 时 中 断 执行 。 代 码 清单 
19-11 展 示 了 如 何在 Home 控 制 器 中 使 用 新 的 过 滤 
Air o 





代码 清单 19-11 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 使 用 自 定义 过 滤器 





using Microsoft.AspNetCore.Mvc; 
using Filters.Infrastructure; 


namespace Filters.Controllers { 


[HttpsOnly] 
public class HomeController : Controller { 


public ViewResult Index() => View("Message", 
"This is the Index action on the Home contr 
oller"); 


public ViewResult SecondAction() => View("Messa 


ge", 
"This is the SecondAction action on the Hom 
e controller"); 
} 
} 








XA FE ME as BT SEL Sis 19-7 
的 操作 方法 的 功能 。 在 实际 项 目 中 ， 与 执行 重 定 回 
《如 内 置 的 RequireHttps 过 滤器 ) 相 比 ， 这 并 没有 
提供 更 多 的 功能 ， 因 为 用 户 不 理解 403 状 态 码 的 含 
义 ， 但 这 个 示例 对 于 演示 授权 过 滤器 如 何 工 作 十 分 

有 用 。 








UUs a HI A rl a 


过 滤器 的 单元 测试 的 大 部 分 工作 是 设置 传递 给 
过 小 器 方法 的 Context 对 象 。 所 震 的 模仿 数据 取决 于 
过 滤器 使 用 的 上 下 文 信息 。 例 如 ， 下 面 是 用 于 代码 
清单 19-10 中 的 HttpsOnly 过 滤器 的 单元 测试 。 





using System.Ling; 

using Filters.Infrastructure; 

using Microsoft.AspNetCore.Http; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.Abstractions; 
using Microsoft.AspNetCore.Mvc.Filters; 
using Moq; 

using Xunit; 


namespace Tests { 
public class FilterTests { 


[Fact] 
public void TestHttpsFilter() { 


// Arrange 
var httpRequest = new Mock<HttpRequest>(); 
httpRequest.SetupSequence(m => m.IsHttps).R 
eturns(true) 
.R 
eturns(false); 


var httpContext = new Mock<HttpContext>() ; 
httpContext.SetupGet(m => m.Request).Return 
s(httpRequest.Object) ; 


var actionContext = new ActionContext(httpC 
ontext.Object, 
new Microsoft.AspNetCore. Routing. RouteD 
ata(), 
new ActionDescriptor()); 
var authContext = new AuthorizationFilterCo 
ntext(actionContext, 
Enumerable.Empty<IFilterMetadata>().ToL 


ist()); 


HttpsOnlyAttribute filter = new HttpsOnlyAt 
tribute(); 


// Act and Assert 
filter.OnAuthorization(authContext) ; 
Assert.Null(authContext.Result) ; 


filter.OnAuthorization(authContext) ; 
Assert. IsType(typeof(StatusCodeResult), aut 
hContext.Result) ; 
Assert. Equal(StatusCodes.Status403Forbidden 
3 
(authContext.Result as StatusCodeResult 
) .StatusCode ) ; 


I 


} 





首先 模仿 HttpRequest 和 HttpContext Context 对 


象 ， 这 样 束 可 以 使 用 或 不 使 用 HTTPS 呈 现 请 求 。 如 
来 想 测 试 这 两 个 条 件 ， 可 以 这 样 做 : 


httpRequest.SetupSequence(m => m.IsHttps).Returns(true). 


Returns(false) ; 





以 上 语句 设置 了 HttpRequest.IsHttps 属 性 ， 使 它 
芭 回 一 系列 测试 值 : 该 属性 在 第 一 次 读 取 时 返回 
true， 并 在 第 二 次 读 取 时 返回 false。 一 旦 有 了 一 个 
HttpContext 对 象 ， 就 可 以 用 它 创 建 一 个 
ActionContext 对 象 ， et 于 执行 单元 测试 的 
AuthorizationContext 对 象 。 通 过 检查 
AuthorizationFilterContext 对 由 的 Result 属 性 ， 可 以 
测试 过 滤器 如 何 啊 应 非 HTTPS 请 求 ， 然 后 测试 
HTTP 请 求 发 生 的 情况 。 设 置 
AuthorizationFilterContext 对 象 时 需要 很 多 类 型 ， 并 
且 它 们 依赖 于 许多 ASP.NET Core 和 MVC 命 名 空 





间 ， 但 是 一 旦 有 了 Context 对 象 ， 那 么 编写 其 余 的 测 
试 束 会 比较 简单 。 


19.5 PRP VE as 


了 解 操作 过 滤器 的 最 佳 方 式 是 查看 它们 的 定 
义 。 以 下 是 IActionFilter 接 口 : 


namespace Microsoft.AspNetCore.Mvc.Filters { 


public interface IActionFilter : IFilterMetadata { 


void OnActionExecuting(ActionExecutingContext c 


ontext) ; 


void OnActionExecuted(ActionExecutedContext con 
text); 
} 

} 








当 操 作 过 滤器 已 应 用 于 操作 方法 时 ， 可 在 调用 
操作 方法 之 前 调用 OnActionExecuting 方 法 ， 之 后 再 





调用 OnActionExecuted 方 法 。 操 作 过 滤 堪 通过 两 个 
不 同 的 上 下 文 类 提供 了 上 下 文 数据 ， 它 们 分 别 古 
OnActionExecuting 方 法 的 ActionExecutingContext 类 
和 OnActionExecuted 方 法 的 ActionExecutedContext 
类 。 这 两 个 上 下 文 类 都 扩展 了 FilterContext 类 ， 评 
见 表 19-4。 


ActionExecutingContext 类 用 于 描述 将 要 调用 的 
操作 ， 表 19-6 摘 述 了 该 类 的 属性 。 


表 19-6 ”ActionExecutingContext 类 的 属性 

















返回 要 调用 操作 方法 的 控制 器 (操作 方法 的 详细 信息 可 通过 从 基 类 继承 

















Controller 


的 ActionDescriptor 属性 获得 ) 





返回 将 传递 给 操作 方法 的 参数 字典 〔 按 名 称 索 引 〉， 过 滤器 可 以 插入 、 
ActionArguments 


移 除 或 更 改 参 数 





























如 果 过 滤器 为 Result 属 性 分 配 IActionResult， 请 求 进程 将 被 跳 过 ， 并 且 操 
作 结 果 将 用 于 在 不 调用 操作 方法 的 情况 下 生成 返回 给 客户 端的 响应 















































ActionExecutedContext 类 用 于 表示 已 执行 的 操 
作 ， 其 中 定义 了 表 19-7 描 述 的 属性 。 


表 19-7 


| 


如 果 另 一 个 操作 过 滤器 通过 将 操作 结果 分 配给 
Canceled ActionExecutingContext 对 象 的 Result 属 性 来 将 请 求 处 理 过 程 短路 ， 
就 将 这 个 属性 设置 为 true 





ActionExecutedContext 类 的 属性 






































操作 方法 的 控制 器 






































包含 由 操作 方法 抛 出 的 所 有 蜡 常 


返回 一 个 ExceptionDispatchInfo 对 象 ， 其 中 包含 由 操作 方法 抛 出 的 任 


ExceptionDispatchInfo 




















何 异 常 的 堆栈 跟踪 详细 信息 


oa | aaa 表示 过 滤器 已 处 理 异常 ， 异 常 不 会 再 进一步 传播 


返 
Result 
或 









































回 由 操作 方法 返回 的 IActionResult。 如 果 需 要 ， 过 滤器 可 以 更 改 
替换 操作 结果 








19.5.1 创建 操作 过 滤器 


操作 过 小 器 是 一 种 通用 工具 ， 可 用 于 实现 应 用 
程序 中 的 任何 横 切 问题 。 操 作 过 滤器 可 用 于 在 调用 
操作 之 前 中 汤 请 求 进程 ， 并 可 在 执行 操作 后 更 改 结 
FR BIE PRT ELE TE ab ft a 
ActionFilterAttribute 类 派生 一 ， 并 让 它 实现 
IActionFilter 接 口 。 为 了 演示 ， AA 
夹 中 添加 一 个 名 为 ProfileAttribute.cs 的 类 文件 ， 内 
容 如 代码 清单 19-12 所 示 。 








代码 清单 19-12 ”Infrastructure 文 件 夹 下 的 ProfileAttribute.cs 文 
件 的 内 容 





using System.Diagnostics; 

using System.Text; 

using Microsoft.AspNetCore.Mvc.Filters; 
namespace Filters.Infrastructure { 


public class ProfileAttribute : ActionFilterAttribu 
te { 
private Stopwatch timer; 


public override void OnActionExecuting(ActionEx 
ecutingContext context) { 
timer = Stopwatch.StartNew(); 
} 


public override void OnActionExecuted(ActionExe 
cutedContext context) { 
timer .Stop(); 
string result = "<div>Elapsed time: " 
+ $"{timer.Elapsed.TotalMilliseconds} m 
S</div>"; 
byte[] bytes = Encoding.ASCII.GetBytes(resu 
1t); 
context ..HttpContext. Response. Body.Write(byt 
es, @, bytes.Length); 
} 


} 





以 上 代码 使 用 Stopwatch 对 象 来 测量 通过 在 
OnActionExecuting 方 法 中 局 动 计时 需 来 执行 操作 方 
法 所 需 的 至 秒 数 ， 并 在 OnActionExecuted 方 法 中 停 
止 计数 。 为 了 观察 结果 ， 可 使 用 Context 对 象 获取 
HttpResponse 对 象 ， 并 在 啊 应 中 包含 简单 的 HIML 
Fr Be. 








代码 清单 19-13 显 示 了 如 何在 Home 控 制 器 上 应 
用 Profile 特 性 〈 这 里 删除 了 以 前 的 过 滤器 ， 以 便 可 
以 接收 HTTP 请 求 ) 。 





cr 


提 ZN 





ARR A TO, Pe tll ae th ee BR EE 
器 。 控 制 器 基 类 实现 了 IActionFilter 和 
IAsyncActionFilter 接 口 ， 这 意味 着 可 以 通过 重 写 这 
些 接口 定义 的 方法 来 创建 操作 过 渡 硕 功能 。 对 于 
POCO 控制 器 ，MVC 检 查 这 些 类 并 检查 它们 是 否 实 
现 了 其 中 一 个 操作 过 滤 需 接口 ， 并 目 动 将 它们 作为 
操作 过 滤器 使 用 。 


代码 清单 19-13 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 应 用 过 滤器 


using Microsoft.AspNetCore.Mvc; 


using Filters.Infrastructure; 
namespace Filters.Controllers { 


[Profile] 
public class HomeController : Controller { 


public ViewResult Index() => View("Message", 
"This is the Index action on the Home contr 
oller"); 


public ViewResult SecondAction() => View("Messa 
ge", 
"This is the SecondAction action on the Hom 
e controller"); 


) 


} 





如 果 运 行 示 例 应 用 程序 ， 你 将 看 到 图 19-4 所 示 
的 结 东 。 你 看 到 的 坚 秒 数 与 开 及 时 使 用 的 计算 机 的 
ERAK. 





GC O localhost: Ww ie 


Elapsed time: 0.1822 ms 


图 19-4 ”运行 结果 


Wo 
y> 2 
ve a 


将 HIMEL 片 段 直接 写 入 响应 依赖 于 浏览 器 能 人 否 
支持 显示 格式 不 正确 的 HTML 文 档 。 你 在 过 滤器 中 
生成 的 div 元 素 出 现在 响应 正文 的 开头 ， 在 Razor 视 
图 生成 表示 HTML 文档 开头 的 DOCTYPE 和 html 元 又 
之 前 。 这 种 技术 可 以 用 于 生成 诊断 信息 ， 但 是 不 应 
该 在 生产 环境 使 用 。 














19.5.2 ”创建 异步 操作 过 滤器 


IAsyncActionFilter 接 口 用 于 定义 异步 操作 的 操 
VEREIS AS JEXT: 


using System.Threading.Tasks; 


namespace Microsoft.AspNetCore.Mvc.Filters { 


public interface IAsyncActionFilter : IFilterMetada 
ta { 


Task OnActionExecutionAsync (ActionExecutingCont 
ext context, 
ActionExecutionDelegate next); 


} 








在 执行 操作 方法 前 后 ， 存 在 依赖 于 任务 延续 的 
单一 方法 ， 该 方法 允许 过 滤 需 和 运行。 代码 清单 19- 
14 显 示 了 如 何在 Profile 过 滤器 中 使 用 
OnActionExecutionAsync 方 法 。 


代码 清单 19-14 在 Infrastructure 文 件 夹 下 的 ProfileAttribute.cs 
文件 中 创建 异步 操作 过 小 器 





using System.Diagnostics; 

using System.Text; 

using System.Threading.Tasks; 

using Microsoft.AspNetCore.Mvc.Filters; 
namespace Filters.Infrastructure { 


public class ProfileAttribute : ActionFilterAttribu 
te { 


public override async Task OnActionExecutionAsy 


nc( 
ActionExecutingContext context, 
ActionExecutionDelegate next) { 


Stopwatch timer = Stopwatch.StartNew() ; 
await next(); 


timer .Stop(); 
string result = "<div>Elapsed time: " 
+ $"{timer.Elapsed.TotalMilliseconds} m 
s</div>"; 
byte[] bytes = Encoding.ASCII.GetBytes(resu 
1t); 


await context.HttpContext.Response.Body.Wri 
teAsync(bytes, 
©, bytes.Length) ; 





ActionExecutingContext®} RA wy as fe HE SE 
下 文 数据 ，ActionExectionDelegate 对 象 表示 要 执行 
的 操作 方法 《或 下 一 个 过 滤器 ) 。 过 小 需 在 调用 委 
托 之 前 做 准备 工作 ， 然 后 在 委托 完成 后 完成 这 些 工 
作 。 代 理会 返回 一 个 Task 对 象 ， 因 而 上 面 的 代码 中 
使 用 了 await 关 键 字 。 


19.6 (EH AG RW UE at 





结果 过 滤器 在 MVC 处 理 操作 方法 返回 的 操作 
结果 的 前 后 应 用 。 结 果 过 滤器 能 够 更 改 或 蔡 换 操作 
结果 或 完全 取消 请 求 〈 即 使 已 调用 操作 方法 ) 。 下 
面 是 定义 结果 过 小 右 的 IResultFilter 接 口 : 











namespace Microsoft.AspNetCore.Mvc.Filters { 


public interface IResultFilter : IFilterMetadata { 


void OnResultExecuting(ResultExecutingContext c 
ontext) ; 


void OnResultExecuted(ResultExecutedContext con 
text); 


} 





} 








ZER ODS ait A SBR VE LE aS FH ARN. Œ 
处 理 操作 方法 产生 的 操作 结 采 之 前 调用 
OnResultExecuting 方法 ， 并 通过 
ResultExecutingContext 对 象 提供 上 下 文 信 息 。 








ResultExecutingContext28 7 M FilterContextikE HY, 


并 定义 了 表 19-8 中 的 属性 。 


表 19-8 ”ResultExecutingContext 类 定义 的 属性 


返回 执行 操作 方法 的 控制 器 
































将 这 个 属性 设置 为 tue， 就 会 停止 处 理 操 作 结 果 以 生成 响应 
返回 由 操作 方法 返回 的 IActionResult 对 象 


调用 OnResultExecuted 方 法 后 ，MVC 已 经 处 理 
了 操作 结果 ， 并 通过 ResultExecutedContext 类 的 实 
例 提 供 了 上 下 文 数 据 ，ResultExecutedContext 类 继 
承 目 FilterContext， 并 定义 了 表 19-9 中 的 属性 。 











表 19-9 ”ResultFExecutedContext 类 定义 的 属性 
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回执 行 操作 方法 的 控 上 





= 


Controller 


X 个 属性 指示 请 求 是 否 被 取消 





Canceled 


Bee 











返回 一 个 ExceptionDispatchInfo 对 象 ， 其 中 包含 由 操作 方法 抛 出 的 任 























何 异常 的 堆栈 跟踪 详细 信息 



















































































于 生成 对 客户 端 啊 应 的 IActionResult 对 象 














19.6.1 JÆ z RW VE A 


ResultFilterAttribute 类 实现 了 结果 过 小 器 接 
口 ， 并 提供 了 创建 结果 过 小 器 的 最 简单 方法 。 为 了 
演示 结果 过 滤器 的 工作 原理 ， 将 一 个 名 为 
ViewResultDetailsAttribute.cs 的 类 文件 添加 到 
Infrastructure 文 件 夹 中 ， 内 容 如 代码 清单 19-15 所 


人 小。 








代码 清单 19-15 ”Infrastructure 文件 夹 下 的 
ViewResultDetailsAttribute.cs 文 件 的 内 容 





using System.Collections.Generic; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.Filters; 
using Microsoft.AspNetCore.Mvc.ModelBinding; 
using Microsoft.AspNetCore.Mvc.ViewFeatures; 


namespace Filters.Infrastructure { 


public class ViewResultDetailsAttribute : ResultFil 
terAttribute { 


public override void OnResultExecuting(ResultEx 
ecutingContext context) { 
Dictionary<string, string> dict = new Dicti 
onary<string, string> { 
["Result Type"] = context.Result.GetTyp 


e().Name, 

}; 

ViewResult vr; 

if ((vr = context.Result as ViewResult) != 
null) { 


dict[ "View Name"] = vr.ViewName; 

dict["Model Type"] = vr.ViewData.Model. 
GetType().Name; 

dict["Model Data"] = vr.ViewData.Model. 
ToString(); 


} 


context.Result = new ViewResult { 
ViewName = "Message", 


ViewData = new ViewDataDictionary( 
new EmptyModelMetadataProvider ( 


) ， 


odel = dict } 


new ModelStateDictionary()) { M 








这 个 类 只 重 写 了 OnResultExecuting 方 法 ， 并 使 
用 Context 对 象 更 改 了 用 于 发 送 啊 应 到 客户 端的 操作 
结果 。 过 滤器 创建 了 一 个 ViewResult 对 象 ， 该 对 象 
使 用 包含 简单 诊断 信息 的 字典 作为 视图 模型 传递 给 
Messageti X « 

















OnResultExecuting 方 法 在 操作 方法 生成 了 操作 
结果 之 后 ， 但 在 处 理 生 成 的 结果 之 前 调用 ， 并 且 更 
改 了 Context 对 象 的 Result 对 象 的 值 ， 从 而 允许 为 应 
用 过 小 强 的 操作 方法 提供 不 同类 型 的 结果 。 代 码 清 
单 19-16 显 示 了 应 用 于 Home 控 制 器 的 结果 过 滤器 。 











代码 清单 19-16 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 


件 中 使 用 结果 过 滤 需 





using Microsoft.AspNetCore.Mvc; 
using Filters.Infrastructure; 


namespace Filters.Controllers { 


[ViewResultDetails ] 
public class HomeController : Controller { 


public ViewResult Index() => View("Message", 


"This is the Index action on the Home contr 
oller"); 


public ViewResult SecondAction() => View("Messa 


"This is the SecondAction action on the Hom 
e controller"); 
} 
} 





如 果 运 行 示例 应 用 程序 ， 你 将 看 到 结果 过 涛 器 
的 效果 ， 如 图 19-5 所 示 。 


A = Cl -| 


G  Ọ localhost wl : 


Name Value 
Result Type ViewResult 
View Name Message 
Model Type String 


Model Data This is the Index action on the Home controller 


图 19-5 ”结果 过 滤器 的 效果 
19.6.2 GRO ARE a 


IAsyncResultFilter 接 口 可 用 于 创建 异步 结果 过 
EAT FE CUP: 


using System. Threading. Tasks; 


namespace Microsoft.AspNetCore.Mvc.Filters { 


public interface IAsyncResultFilter : IFilterMetada 
ta { 


Task OnResultExecutionAsync(ResultExecutingCont 
ext context, 
ResultExecutionDelegate next); 


} 








这 个 接口 类 似 于 异步 操作 过 滤器 。 代 码 清单 
19-17 重 写 了 ViewResultDetailsAttribute 类 以 实现 
IAsyncResultFilter 接 口 。 


代码 清单 19-17 在 Infrastructure 文 件 夹 下 的 


ViewResultDetailsAttribute.cs 文 件 中 创建 异步 结果 过 滤器 





using System.Collections.Generic; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.Filters; 
using Microsoft.AspNetCore.Mvc.ModelBinding; 
using Microsoft.AspNetCore.Mvc.ViewFeatures; 


namespace Filters.Infrastructure { 
public class ViewResultDetailsAttribute : ResultFil 
terAttribute { 


public override async Task OnResultExecutionAsy 
nc( 
ResultExecutingContext context, 
ResultExecutionDelegate next) { 


Dictionary<string, string> dict = new Dicti 
onary<string, string> { 
["Result Type"] = context.Result.GetTyp 


e().Name, 

}; 

ViewResult vr; 

if ((vr = context.Result as ViewResult) != 
null) { 


dict["View Name"] = vr.ViewName; 

dict["Model Type"] = vr.ViewData.Model. 
GetType().Name; 

dict["Model Data"] = vr.ViewData.Model. 
ToString(); 


} 


context.Result = new ViewResult { 
ViewName = "Message", 
ViewData = new ViewDataDictionary( 
new EmptyModelMetadataProvider ( 


new ModelStateDictionary()) { 
Model = dict 
} 
}; 


await next(); 








请 注意 ， 需 要 负责 调用 作为 
OnResultExecutionAsync 方 法 的 参数 接收 的 委托 。 
如 果 不 调 用 委托 ， 请 求 处 理 管道 将 不 会 完成 ， 并 且 


不 会 呈现 操作 结 











19.6.3 ”创建 混合 操作 /结果 过 滤器 

区 分 请 求 处 理 的 操作 阶段 和 结果 阶段 并 不 总 是 
有 帮助 。 这 可 能 是 因为 你 希望 将 两 个 阶段 视 为 一 个 
步骤 ， 或 是 因为 你 希望 过 滤器 影响 啊 应 执行 操作 的 








方式 ， 而 不 是 通过 干预 结果 来 实现 。 因 此 ， 能 够 创 
建 既 可 以 是 操作 过 沽 磊 又 可 以 是 结果 过 滤器 ， 并 且 
能 够 在 每 个 阶段 执行 工作 的 过 小强 是 非 第 有 用 的 。 











以 下 要 求 很 音 见 : 要 求 ActionFilterAttribute 类 
实现 两 种 类 型 的 过 滤器 接口 ， 这 意味 着 可 以 在 单个 
属性 中 混合 和 匹配 过 滤 堪 类 型 。 为 了 演示 这 是 如 何 
工作 的 ， 修 改 代码 清单 19-18 中 的 ProfileAttribute 类 
的 代码 ， 以 便 将 操作 过 滤 颖 与 结果 过 滤器 相 结合 。 





代码 清单 19-18 ”在 Infrastructure 文 件 夹 下 的 ProfileAttribute.cs 
文件 中 创建 混合 过 滤器 





using System.Diagnostics; 

using System. Text; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore.Mvc.Filters; 
namespace Filters.Infrastructure { 


public class ProfileAttribute : ActionFilterAttribu 
te { 
private Stopwatch timer; 
private double actionTime; 


public override async Task OnActionExecutionAsy 


nc( 
ActionExecutingContext context, 
ActionExecutionDelegate next) { 
timer = Stopwatch.StartNew() ; 


await next(); 


actionTime = timer.Elapsed.TotalMillisecond 


S5 
} 
public override async Task OnResultExecutionAsy 
nc( 
ResultExecutingContext context, 
ResultExecutionDelegate next) { 
await next(); 
timer .Stop(); 
string result = "<div>Action time: " 
+ $"{actionTime} ms</div><div>Total tim 
e: W 
+ $"{timer.Elapsed.TotalMilliseconds} m 
s</div>"; 
byte[] bytes = Encoding.ASCII.GetBytes(resu 
1t); 


await context.HttpContext.Response.Body.Wri 
teAsync(bytes, 


©, bytes.Length) ; 





这 里 对 两 种 类 型 的 过 涛 颖 使 用 了 开 步 方法 ， 但 
也 可 以 混合 使 用 它们 ， 从 而 获取 所 需 的 功能 ， 因 为 
这 些 方法 的 默认 实现 会 调用 它们 的 同步 对 应 版 本 。 
在 过 滤器 中 ， 可 使 用 Stopwatch 来 测量 要 处 理 的 操作 
所 需 的 时 间 ， 以 及 总 的 经 历时 间 ， 并 将 结果 写 入 啊 
应 。 代 但 清单 19-19 已 将 混合 过 涛 融 应 用 于 Home 控 
HIA o 








代码 清单 19-19 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 使 用 混合 过 滤器 








using Microsoft.AspNetCore.Mvc; 
using Filters.Infrastructure; 


namespace Filters.Controllers { 


[Profile] 
[ViewResultDetails ] 
public class HomeController : Controller { 
public ViewResult Index() => View("Message", 
"This is the Index action on the Home contr 
oller"); 


public ViewResult SecondAction() => View("Messa 
ge", 
"This is the SecondAction action on the Hom 


e controller"); 
} 
} 


如 果 运 行 示例 应 用 程序 ， 你 将 看 到 类 似 于 图 
19-6 的 输出 。 输 出 显示 在 ViewResultDetails 提 供 的 
内 容 之 后 ， 因 为 是 在 结果 过 小 器 的 最 后 处 理 阶 段 写 
入 的 ， 而 不 是 来 自 先 前 版 本 中 使 用 的 操作 过 滤器 。 





Name Value 


Result Type ViewResult 
View Name Message 
Model Type String 


Model Data This is the Index action on the Home controller 


Action time: 5.9253 ms 
Total time: 1745.284 ms 


图 19-6 ”混合 操作 /结果 过 滤器 的 输出 
19.7 使 用 异常 过 小 此 


寞 党 过 小 器 允许 啊 应 异常 ， 而 无 须 在 每 个 操作 
方法 中 写 入 try ... catch 代 码 块 。 异 和 常 过 滤器 可 以 应 








用 于 控制 右 类 或 操作 方法 。 当 操作 方法 或 已 应 用 于 
操作 方法 的 操作 过 涛 器 或 结果 过 涛 堪 未 处 理 寞 第 
时 ， 将 会 调用 它们 (操作 过 小 右 和 结果 过 滤 颖 可 以 
通过 将 Context 对 象 的 ExceptionHandled 属 性 设置 为 
true Jkh HERCE o e LERKIN S 
IExceptionFilter 接 口 ， 定 义 如 下 : 














namespace Microsoft.AspNetCore.Mvc.Filters { 


public interface IExceptionFilter : IFilterMetadata 


{ 


void OnException(ExceptionContext context) ; 


} 





} 

ON FRIES BY ASAE oe as» JU Fe] H On Exception 
方法 。IAsyncExceptionFilter 接 口 可 用 于 创建 异步 异 
第 过 滤器 ， 如 果 需 要 使 用 异步 API 啊 应 异常 ， 这 将 
非常 有 用 。 以 下 是 异步 接口 的 定义 : 


using System.Threading.Tasks; 








namespace Microsoft.AspNetCore.Mvc.Filters { 


public interface IAsyncExceptionFilter : IFilterMet 
adata { 


Task OnExceptionAsync(ExceptionContext context) 








OnExceptionAsync 方 法 是 来 目 IExceptionFilter 
接口 的 OnException 方 法 的 异步 对 象 ， 当 存在 未 处 理 
的 异常 时 调用 。 


IAsyncExceptionFilter 接 口 和 IExceptionFilter 接 
口 都 通过 ExceptionContext 类 提供 上 下 文 数据 ， 该 
类 派生 自 FilterContext， 并 定义 了 表 19-10 中 描述 的 
属性 。 


表 19-10 ExceptionContext 类 定义 的 属性 



































回 一 个 ExceptionDispatchInfo 对 象 ， 该 对 象 包含 异常 的 栈 跟踪 详 旨 


zzl 





w w 


ExceptionDispatchInfo 














ExceptionHandled 这 个 属性 用 于 指示 异常 
































设置 将 用 于 生成 响应 的 IActionResult 


BIE A ROS A 








ExceptionFilterAttribute 类 实现 了 两 个 异常 过 滤 
器 接口 ， 也 是 创建 过 小 终 的 最 徐 单 方法 ， 可 以 应 用 
为 属性 。 寞 和 常 过 小 右 的 常见 用 途 是 为 特定 寞 第 类 型 
提供 目 定 义 错误 页 面 ， 以 便 为 用 户 提 供 相 比 标准 错 
误 处 理 功能 所 能 提供 的 更 有 用 的 信息 。 例 如 ， 将 一 
个 名 为 RangeExceptionAttribute.cs 的 类 文件 添加 到 
Infrastructure 文 件 夹 中 ， 文 件 内 容 如 代码 清单 19-20 
所 示 。 











代码 清单 19-20 ”Infrastructure 文 件 夹 下 的 
RangeExceptionAttribute.cs 文 件 的 内 容 


uSing System; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.Filters; 
using Microsoft.AspNetCore.Mvc.ModelBinding; 
using Microsoft.AspNetCore.Mvc.ViewFeatures; 


namespace Filters.Infrastructure { 
public class RangeExceptionAttribute : ExceptionFil 
terAttribute { 


public override void OnException(ExceptionConte 
xt context) { 
if (context.Exception is ArgumentOutOfRange 
Exception) { 
context.Result = new ViewResult() { 
ViewName = "Message", 
ViewData = new ViewDataDictionary ( 
new EmptyModelMetadataProvider ( 


) ， 


new ModelStateDictionary()) { 
Model = @"The data received 


by the 
application cannot be 
processed" 





这 个 过 滤 需 使 用 ExceptionContext 对 象 获取 未 处 
理 异常 的 类 型 ， 如 果 类 型 为 


ArgumentOutOfRangeException， 则 会 创建 用 于 问 用 
户 显 示 消 息 的 操作 结 末 。 代 但 清单 19-21 癌 Home 控 
制 颖 洪 加 一 个 操作 方法 ， 并 将 异 音 过 小 器 应 用 到 这 
个 操作 方法 。 








代码 清单 19-21 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 应 用 异常 过 滤器 





using Filters.Infrastructure; 
using Microsoft.AspNetCore.Mvc; 
using System; 


namespace Filters.Controllers { 


[Profile] 

[ViewResultDetails | 

[RangeException] 

public class HomeController : Controller { 


public ViewResult Index() => View("Message", 
"This is the Index action on the Home contr 
oller"); 


public ViewResult SecondAction() => View("Messa 


"This is the SecondAction action on the Hom 
e controller"); 


public ViewResult GenerateException(int? id) { 


if (id == null) { 
throw new ArgumentNullException(nameof ( 


id)); 
} else if (id > 10) { 
throw new ArgumentOutOfRangeException(n 
ameof(id)); 
} else { 
return View( "Message", $"The value is { 
id}"); 





GenerateException 操 作 方 法 依赖 默认 路 由 模式 
从 请 求 URL 中 接收 可 空 的 int 值 。 如 果 值 为 null， 操 
作 方 法 将 抛 出 ArgumentNullException 异 常 ;， 如 果 值 
大 于 50， 则 抛 出 ArgumentOutOfRangeException 异 
音 。 如 采 有 值 且 在 指定 范围 内 ， 那 么 操作 方法 返回 
一 个 ViewResult 对 象 。 


可 以 通过 运行 示例 应 用 程序 并 请 求 URL 
一 /Home/GenerateException/100 来 测试 异常 过 滤 
费 。 最 后 一 段 已 超出 操作 方法 的 预期 范围 ， 这 将 抛 





出 由 过 小 器 处 理 的 异常 类 型 ， 产 生 图 19-7 所 示 的 结 
果 。 如 果 请 求 URL 一 一 /Home/ GenerateException, 
那么 由 操作 方法 抛 出 的 异 第 将 不 会 被 过 滤器 处 理 ， 
并 且 将 使 用 默认 错误 处 理 。 


The data received by the application cannot be processed 





图 19-7 ”使 用 异常 过 滤器 
19.8 ”为 过 滤 硕 使 用 依赖 注入 


当 从 convenience 属 性 类 (如 
ExceptionFilterAttribute) JR-AWYERSIN, MVCH 
建 过 滤器 类 的 新 实例 来 处 理 每 个 请 求 。 这 是 一 种 合 
理 的 方法 ， 因 为 可 以 避免 任何 可 能 的 重用 或 并 发 问 
Ü, FFA WE S FRAR ie IN KS Bol Ve as 





为 一 种 方法 是 使 用 依赖 注入 系统 为 过 滤 占 选择 
不 同 的 生命 周期 。 在 过 滤 占 中 使 用 依赖 注入 有 两 种 
不 同 的 方法 ， 下 面 进行 介绍 。 


19.8.1 解决 过 滤器 依赖 项 





此 一 种 方法 是 使 用 依赖 注入 来 省 理 过 小 器 的 上 
下 文 数据 ， 以 允许 不 同类 型 的 过 滤 问 共 至 数据 ， 或 
APS is a EGE MSE BAAS Ef A Pb 
他 请 求 。 为 了 演示 这 是 如 何 工作 的 ， 在 
Infrastructure 文 件 夹 中 添加 一 个 名 为 
FilterDiagnostics.cs 的 类 文件 ， 内 容 如 代码 清单 19- 
22 所 未 。 








代码 清单 19-22 ”Infrastructure 文 件 夹 下 的 FilterDiagnostics.cs 文 
件 的 内 容 





using System.Collections.Generic; 


namespace Filters.Infrastructure { 


public interface IFilterDiagnostics { 
TEnumerable<string> Messages { get; } 
void AddMessage(string message) ; 


public class DefaultFilterDiagnostics : IFilterDiag 
nostics { 


private List<string> messages = new List<string 


>(); 


public IEnumerable<string> Messages => messages 


public void AddMessage(string message) => 
messages.Add(message) ; 








IFilterDiagnostics 接 口 定 义 了 一 个 简单 的 模型 ， 
用 于 在 中 选 过 程 中 收集 诊断 消息 。 这 里 将 使 用 
DefaultFilterDiagnostics 类 来 实现 。 人 代码 清单 19-23 更 
新 了 Startup 关 ， 以 使 用 新 的 接口 及 其 实现 来 配置 服 
务 提供 者 。 








代码 清单 19-23 ”在 Filters 文 件 夹 下 的 Startup.cs 文 件 中 配置 服务 
提供 者 


using System; 
using System.Collections.Generic; 


using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Filters.Infrastructure; 


namespace Filters { 
public class Startup { 
public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddScoped<IFilterDiagnostics, Defa 
ultFilterDiagnostics>(); 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 








以 上 代码 使 用 AddScoped 扩 展 方法 来 配置 服务 
提供 者 ， 这 意味 看 所 有 实例 化 的 处 理 单个 请 求 的 过 
滤器 都 将 收 到 相同 的 DefaultFilterDiagnostics 对 象 。 
这 是 在 过 滤 锋 之 间 共 孕 目 定义 上 下 文 数 据 的 基础 。 





1. 创建 具有 依赖 关系 的 过 滤 需 


下 一 步 是 创建 在 IFilterDiagnostics 接 口上 声明 依 
赖 关 系 的 过 小 器 。 在 Infrastructure 文 件 洋 中 创建 一 
个 名 为 TimeFilter.cs 的 类 文件 ， 内 容 如 代码 清单 19- 
24 所 示 。 


代码 清单 19-24 Infrastructure 文件 夹 下 的 TimeFilter.cs 文 件 的 内 


IP 


谷 





using System.Diagnostics; 
using System. Threading. Tasks; 
using Microsoft.AspNetCore.Mvc.Filters; 


namespace Filters.Infrastructure { 


public class TimeFilter : IAsyncActionFilter, IAsyn 
cResultFilter { 
private Stopwatch timer; 
private IFilterDiagnostics diagnostics; 


public TimeFilter(IFilterDiagnostics diags) { 
diagnostics = diags; 


} 


public async Task OnActionExecutionAsync( 
ActionExecutingContext context, 
ActionExecutionDelegate next) { 


timer = Stopwatch.StartNew( ) ; 
await next(); 
diagnostics.AddMessage(¢@"Action time: 
{timer .Elapsed.TotalMilliseconds}"); 
} 


public async Task OnResultExecutionAsync( 
ResultExecutingContext context, 
ResultExecutionDelegate next) { 


await next(); 

timer .Stop(); 

diagnostics.AddMessage($¢@"Result time: 
{timer .Elapsed.TotalMilliseconds}"); 








TimeFilter 类 是 混合 操作 /结果 过 滤器 ， 可 从 先 
前 的 示例 重新 创建 计时 器 功能 ， 但 使 用 
IFilterDiagnostics 接 口 存 储 定 时 信息 ， 访 接口 被 声明 
为 构造 图 数 参数 ， 并 在 创建 过 滤器 时 由 依赖 注入 系 
统 提 供 。 








请 注意 ，TimeFilter 类 直接 实现 了 过 滤器 接 
口 ， 而 不 是 从 convenience 属 性 类 派生 。 正 如 你 将 看 








到 的 ， 依 赖 于 依赖 注入 的 过 涯 磺 症 通过 不 同 的 属性 
应 用 的 ， 并 且 不 用 于 直接 修饰 控制 各 或 action。 





为 了 演示 过 小 右 如 何 使 用 依赖 项 注入 来 共享 上 
下 文 数据 ， 在 Infrastructure 文 件 夹 中 添加 一 个 名 为 
DiagnosticsFilter.cs 的 类 文件 ， 内 容 如 代码 清单 19- 
25 所 示 。 


代码 清单 19-25 ”Infrastructure 文 件 夹 下 的 DiagnosticsFilter.cs 文 
件 的 内 容 





using System.TexXt ; 
using System.Threading.TasKs ; 
using Microsoft.AspNetCore.Mvc.Filters; 


namespace Filters.Infrastructure { 


public class DiagnosticsFilter : IAsyncResultFilter 


í 


private IFilterDiagnostics diagnostics; 


public DiagnosticsFilter(IFilterDiagnostics dia 


gs) { 


diagnostics = diags; 


} 


public async Task OnResultExecutionAsync( 


ResultExecutingContext context, 
ResultExecutionDelegate next) { 


await next(); 


foreach (string message in diagnostics?.Mes 
sages) { 


byte[] bytes = Encoding.ASCII 
.GetBytes($"<div>{message}</div>"); 

await context.HttpContext.Response. Body 
.WriteAsync(bytes, ©, bytes.Length) 








DiagnosticsFilter 类 是 结果 过 滤器 ， 可 将 
IFilterDiagnostics 接 口 的 实现 作为 构造 函数 参数 接 
收 ， 并 将 其 中 包 售 的 消息 写 入 啊 应 。 





2. MA WEA 


Bela 2 eh ROE A H PH AER o a 
C# 属 性 不 具有 解析 构造 函数 依赖 项 的 整体 能 
束 是 前 面 的 过 小 此 不 是 属性 的 原因 。 相 反 ， 而 是 应 








用 TypeFilter 特 性 ， 并 使 用 所 需 的 过 滤 右 类 型 进行 配 
置 ， 如 代码 清单 19-26 所 示 。 


代码 清单 19-26 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 应 用 使 用 依赖 注入 的 过 滤器 














using Microsoft.AspNetCore.Mvc; 
using Filters.Infrastructure; 
using System; 


namespace Filters.Controllers { 


[TypeFilter (typeof (DiagnosticsFilter) ) ] 
[TypeFilter (typeof (TimeFilter) ) ] 
public class HomeController : Controller { 


public ViewResult Index() => View("Message", 
"This is the Index action on the Home contr 
oller"); 


public ViewResult SecondAction() => View("Messa 


ge , 
"This is the SecondAction action on the Hom 
e controller"); 


public ViewResult GenerateException(int? id) { 
if (id == null) { 
throw new ArgumentNullException(nameof( 
id)); 
} else if (id > 10) { 
throw new ArgumentOutOfRangeException(n 


ameof(id)); 
} else { 
return View("Message", $"The value is { 


id}"); 





提 示 





代码 清单 19-26 中 过 滤器 的 应 用 顺序 很 重要 ， 
正如 19.10 节 中 解释 的 那样 。 





TypeFilter 特 性 为 每 个 请 求 创建 过 渡 旨 类 的 新 实 
Bil, {EE FA HOBIE ATI BE, ORF A DA GUE RA 
的 组 件 ， 并 将 用 于 解决 依赖 关系 的 对 象 置 于 生命 周 





期 管理 之 下 。 


在 该 例 中 ， 这 意味 着 代码 清单 19-26 中 应 用 的 
两 个 过 滤 右 都 将 接收 到 相同 的 IFilterDiagnostics 实 现 
对 象 ， 因 此 TimeFilter 类 写 入 的 消息 将 被 
DiagnosticsFilter 类 写 入 啊 应 。 图 19-8 显示 了 启动 应 
用 程序 并 请 求 应 用 程序 的 默认 URL 后 可 以 看 到 的 效 











图 19-8 ”局 动 应 用 程序 并 请 求 应 用 程序 的 默认 URL 的 效果 





19.8.2 ”管理 过 滤器 的 生命 周期 


| ， 会 为 每 个 请 求 创 建 过 
小 右 类 的 新 实例 。 这 与 将 过 小 右 作 为 属性 直接 应 用 
的 行为 相同 ， 只 是 TypeFilter 特 性 允许 过 滤器 类 声明 





通过 服务 提供 者 解析 的 依赖 项 。 


相 比 使 用 ServiceFilter 特 性 更 进一步 ， 可 使 用 服 
务 提供 者 创建 过 小 器 对 象 。 这 使 得 过 滤器 对 象 也 可 
以 置 于 生命 周期 省 理 之 下 。 作 为 演示 ， 代 码 清 单 
19-27 修 改 了 TimeFilter 类 ， 以 便 保持 简单 的 平均 时 
间 值 。 





代码 清单 19-27 在 Infrastructure 文 件 夹 下 TimeFilter.cs 文 件 中 保 
村 简单 的 平均 时 间 值 





using System.Collections.Concurrent ; 
using System.Diagnostics; 

using System.Ling; 

using System. Threading.Tasks; 

using Microsoft.AspNetCore.Mvc.Filters; 


namespace Filters.Infrastructure { 


public class TimeFilter : IAsyncActionFilter, IAsyn 
cResultFilter { 


private ConcurrentQueue<double> actionTimes = n 
ew ConcurrentQueue<double>() ; 
private ConcurrentQueue<double> resultTimes = n 


ew ConcurrentQueue<double>() ; 
private IFilterDiagnostics diagnostics; 


public TimeFilter(IFilterDiagnostics diags) { 


} 


diagnostics = diags; 


public async Task OnActionExecutionAsync( 


ActionExecutingContext context, ActionE 


xecutionDelegate next) { 


iseconds); 


} 


Stopwatch timer = Stopwatch.StartNew(); 
await next(); 

timer.Stop(); 

actionTimes .Enqueue(timer.Elapsed.TotalMill 


diagnostics.AddMessage($@"Action time: 
{timer .Elapsed.TotalMilliseconds} 
Average: {actionTimes.Average():F2}"); 


public async Task OnResultExecutionAsync( 


ResultExecutingContext context, ResultE 


xecutionDelegate next) { 


iseconds) ; 


Stopwatch timer = Stopwatch.StartNew() ; 
await next(); 

timer .Stop(); 
resultTimes.Enqueue(timer.Elapsed.TotalMill 


diagnostics.AddMessage($@"Result time: 
{timer .Elapsed.TotalMilliseconds} 
Average: {resultTimes.Average():F2}"); 





过 滤器 现在 使 用 线程 安全 的 集合 来 存储 为 请 求 
处 理 的 操作 阶段 和 结果 阶段 记录 的 时 间 ， 并 在 每 次 
处 理 请 求 时 使 用 单独 的 Stopwatch。 人 代码 清单 19-28 

已 经 在 Startup 类 中 将 TimeFilter 类 注册 为 服务 提供 者 
的 单 例 。 


代码 清单 19-28 ”在 Filters 文 件 夹 下 的 Startup.cs 文 件 中 配置 服务 
提供 者 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Filters.Infrastructure; 


namespace Filters { 
public class Startup { 
public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<IFilterDiagnostics, D 
efaultFilterDiagnostics>(); 
services.AddSingleton<TimeFilter>(); 
services.AddMvc(); 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 





请 注意 ， 这 里 还 改变 了 IFilterDiagnostics 的 生命 
周期 ， ss 如 果 继 续 为 每 个 请 求 创建 一 
个 新 的 实例 ， 那 么 单 例 TimeFilter 将 从 
DiagnosticsFilter 接 收 一 个 不 同 的 IEilterDiagnostics 对 
象 ， 该 对 象 继续 通过 TypeFilter 特 性 进行 实例 化 ， 并 
为 每 个 请 求 创建 一 个 。 


MHINE as 


(EH Service Type VE UE as A TFE EAS 
如 代码 清单 19-29 所 示 。 


代码 清单 19-29 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 


件 中 使 用 过 滤器 


using Microsoft.AspNetCore.Mvc; 
using Filters.Infrastructure; 
using System; 


namespace Filters.Controllers { 
[TypeFilter(typeof(DiagnosticsFilter) ) ] 
[ServiceFilter(typeof(TimeFilter) ) ] 
public class HomeController : Controller { 


public ViewResult Index() => View("Message", 
"This is the Index action on the Home contr 
oller"); 


public ViewResult SecondAction() => View("Messa 


"This is the SecondAction action on the Hom 
e controller"); 


public ViewResult GenerateException(int? id) { 
if (id == null) { 
throw new ArgumentNullException(nameof( 


id)); 
} else if (id > 10) { 
throw new ArgumentOutOfRangeException(n 
ameof(id)); 
} else { 
return View( "Message", $"The value is { 


id}"); 





可 以 通过 运行 示例 应 用 程序 并 请 求 默认 URL 来 
查看 效果 。 因 为 IFilterDiagnostics 接 口 的 单个 ~ 
象 用 于 解析 所 有 依赖 关系 ， 所 以 显示 的 消息 集合 
随 着 每 个 请 求 而 建立 ， 如 图 19-9 所 示 。 








口 Filters 
€ G |© localhost51( 女 | : 


This is the Index action on the Home controller 

Action time: 5.9988 Average: 6.00 

Result time: 1824.5787 Average: 1824.58 

Action time: 0.1644 Average: 3.08 

Result time: 1.813 Average: 913.20 

Action time: 0.078 Average: 2.08 

Result time: 0.2993 Average: 608.90 

Action time: 0.046 Average: 1.57 

Result time: 0.4225 Average: 456.78 
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图 19-9 ”使 用 service provider 管 理 过 滤器 的 生命 周期 


19.9 创建 全 局 过 滤器 


你 可 以 将 过 滤器 应 用 于 控制 器 类 ， 而 不 必 将 它 
们 应 用 于 各 个 操作 方法 。 全 局 过 滤器 更 进一步 ， 只 
在 Startup 类 中 应 用 一 次 ， 就 可 自动 应 用 于 应 用 程序 
的 每 个 控制 器 中 的 每 个 操作 方法 。 任 何 过 滤器 都 可 





以 用 作 全 局 过 滤器 ， 为 了 演示 ， 创 建 一 个 名 为 
ViewResultDiagnostics.cs 的 类 文件 并 保存 到 
Infrastructure 文 件 夹 中 ， 文 件 的 内 容 如 代码 清单 19- 
30 所 示 。 


代码 清单 19-30 ”Infrastructure 文 件 夹 下 的 
ViewResultDiagnostics.cs 文 件 的 内 容 





using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.Filters; 


namespace Filters.Infrastructure { 
public class ViewResultDiagnostics : IActionFilter 


{ 


private IFilterDiagnostics diagnostics; 


public ViewResultDiagnostics(IFilterDiagnostics 
diags) { 
diagnostics = diags; 


} 


public void OnActionExecuting(ActionExecutingCo 
ntext context) { 
// do nothing - not used in this filter 


} 


public void OnActionExecuted(ActionExecutedCont 
ext context) { 
ViewResult vr; 


if ((vr = context.Result as ViewResult) != 
null) { 
diagnostics.AddMessage($"View name: {vr 
. ViewName}") ; 


diagnostics.AddMessage($@"Model type: 
{vr.ViewData.Model.GetType().Name}" 








这 个 过 滤器 使 用 IFilterDiagnostics 对 象 来 存储 有 
KViewResult action 结 果 的 视图 名 称 和 模型 类 型 方 
面 的 消息 。 代 码 清单 19-31 将 这 个 过 滤器 与 
DiagnosticsFilter 类 一 起 应 用 于 人 全局， 过滤 融 依赖 于 
DiagnosticsFilter 类 写 入 诊断 消息 。 


代码 清单 19-31 ”在 Filters 文 件 夹 下 的 Startup.cs 文 件 中 注册 全 局 





using System; 

using System.Collections.Generic; 
using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 
using Microsoft.AspNetCore.Hosting; 
using Microsoft.AspNetCore.Http; 


using Microsoft.Extensions.DependencyInjection; 
using Filters.Infrastructure; 
namespace Filters { 
public class Startup { 
public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddScoped<IFilterDiagnostics, Defa 
ultFilterDiagnostics>(); 
services.AddScoped<TimeFilter>() ; 
services .AddScoped<ViewResultDiagnostics>(); 


services .AddScoped<DiagnosticsFilter>(); 
services.AddMvc().AddMvcOptions(options => { 


options.Filters.AddService(typeof(ViewR 
esultDiagnostics)); 
options.Filters.AddService(typeof (Diagn 
osticsFilter) ); 
}); 
} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 





全 局 过 滤 磊 是 通过 配置 MVC 服 务 包 来 设置 
的 。 本 例 使 用 了 全 局 过 小 右 的 


MvcOptions.Filters.AddService 方 法 。AddService 方 
法 接收 将 使 用 ConfigureServices 方 法 中 其 他 位 置 指 
定 的 生命 周期 规则 实例 化 的 .NET 类 型 。 可 将 其 他 过 
滤 需 类型 的 生命 周期 更 改 为 范围 受 限 ， 以 便 为 每 个 
请 求 创 建新 的 实例 。 因 此 ， 将 会 为 每 个 控制 器 的 每 
个 请 求 创 建 并 应 用 ViewResultDiagnostics 和 
DiagnosticsFilter 过 滤器 的 新 实例 。 


人 


JE ZR 

还 可 以 使 用 Add 方 法 而 不 是 AddService 方 法 添 
加 全 局 过 滤器 ， 这 样 就 可 以 将 过 滤器 对 象 注 册 为 全 
局 过 滤器 ， 而 不 依赖 于 依赖 注入 和 服务 提供 者 。 


将 一 个 名 为 GlobalController.cs 的 类 文件 添加 到 
Controllers 文 件 夹 中 ， 内 容 如 代码 清单 19-32 所 示 。 


代码 清单 19-32 ”Controllers 文 件 夹 下 的 GlobalController.cs 文 件 
的 内 容 


using Microsoft.AspNetCore.Mvc; 


namespace Filters.Controllers { 
public class GlobalController : Controller { 


public ViewResult Index() => View("Message", 
"This is the global controller"); 





BOA CAE AAT REE 48s ZA FF Global #2 ill 48, 1840 
果 启 动 应 用 程序 并 请 求 /global， 你 将 看 到 两 个 全 局 
过 滤器 的 输出 ， 如 图 19-10 所 示 。 





This is the global controller 


View name: Message 
Model type: String 


图 19-10 两 个 全 局 过 滤器 的 输出 


19.10 ”理解 和 更 改过 小峰 的 执行 顺序 


过 小 如 以 特定 顺序 运行 ， 即 授权 过 滤器 ,操作 
过 小 大 一 结果 过 渡 左 。 但 是 ， 如 和 朱 有 多 个 给 定 关 型 
的 过 涛 项 ， 则 乞 们 的 应 用 顺序 申 己 应 用 过 滤器 的 范 
转 驱 动 。 为 了 演示 这 如 何 工 作 ， 将 一 个 名 为 
MessageAttribute.cs 的 类 文件 添加 a 到 Infrastructure 文 
件 夹 中 ， 文 件 内 容 如 代码 清单 19-33 所 示 。 








代码 清单 19-33 ”Infrastructure 文 件 夹 下 的 MessageAttribute.cs 文 
件 的 内 容 





using System.Text; 
using Microsoft.AspNetCore.Mvc.Filters; 


namespace Filters.Infrastructure { 


public class MessageAttribute : ResultFilterAttribu 
te { 
private string message; 


public MessageAttribute(string msg) { 
message = msg; 


} 


public override void OnResultExecuting(ResultEx 
ecutingContext context) { 
WriteMessage(context, $"<div>Before Result: 
{message}</div>"); 


} 


public override void OnResultExecuted(ResultExe 
cutedContext context) { 
WriteMessage(context, $"<div>After Result:{ 
message }</div>"); 


private void WriteMessage(FilterContext context 
» string msg) { 
byte[] bytes = Encoding.ASCII 
.GetBytes($"<div>{msg}</div>"); 
context. .HttpContext.Response 
.Body.Write(bytes, ©, bytes.Length) ; 








这 是 一 个 结果 过 小 器 ， 但 并 非 在 处 理 操作 结果 
ee Wye aS SAME Ze 

过 构造 函数 参数 来 配置 的 ， 该 参数 在 应 用 为 属性 
nee 以 使 用 。 代 码 清单 19-34 简 化 了 Home 控 制 器 ， 
并 将 以 前 示例 中 的 过 滤器 蔡 换 为 Message 过 滤 吉 的 








多 个 实例 。 


代码 清单 19-34 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 使 用 过 滤器 


using Microsoft.AspNetCore.Mvc; 
using Filters.Infrastructure; 


namespace Filters.Controllers { 


[Message("This is the Controller-Scoped Filter") ] 
public class HomeController : Controller { 


[Message("This is the First Action-Scoped Filte 
r")] 


er") ] 


[Message("This is the Second Action-Scoped Filt 


public ViewResult Index() => View("Message", 
"This is the Index action on the Home contr 


oller"); 


} 
} 











上 面 已 经 修改 了 一 组 全 局 过 滤器 ， 以 便 在 这 里 
使 用 Message 过 滤器 ， 如 代码 清单 19-35 所 示 。 


代码 清单 19-35 在 Filters 文 件 夹 下 的 Startup.cs 文 件 中 创建 全 局 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Filters.Infrastructure; 


namespace Filters { 
public class Startup { 
public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddScoped<IFilterDiagnostics, Defa 
ultFilterDiagnostics>(); 
services.AddScoped<TimeFilter>() ; 
services.AddScoped<ViewResultDiagnostics>() 


services.AddScoped<DiagnosticsFilter>() ; 
services.AddMvc().AddMvcOptions(options => 


options.Filters.Add(new 
MessageAttribute("This is the Globa 
lly-Scoped Filter")); 
}); 
} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 


) } 


当 Index 操 作 方 法 啊 应 请 求 时 ， 将 使 用 4 个 过 渡 
俐 实例 。 如 果 运 行 应 用 程序 并 请 求 默 认 URL， 你 将 
在 浏览 费 中 看 到 以 下 输出 : 


Before Result:This is the Globally-Scoped Filter 
Before Result:This is the Controller-Scoped Filter 
Before Result:This is the First Action-Scoped Filter 
Before Result:This is the Second Action-Scoped Filter 


After Result: This is the Second Action-Scoped Filter 
After Result:This is the First Action-Scoped Filter 
After Result:This is the Controller-Scoped Filter 
After Result:This is the Globally-Scoped Filter 





默认 情况 下 ，MVC 运行 全 局 过 小 器， 然后 将 
过 滤 需 应 用 于 控制 磺 ， 最 后 将 过 滤器 应 用 于 操作 方 
法 。 一 旦 调用 操作 方法 或 处 理 操 作 结 果 ， 过 滤器 的 
Bem BARI I, Aliant a After Result 消 恩 以 相 
反 的 顺 友 显示 。 





修改 过 滤器 的 执行 顺序 


可 以 通过 实现 IOrderedFilter 接 口 来 更 改 默 认 顺 
序 ，MYVC 在 指定 如 何 按 顺 序 堆 闭 过 滤器 的 过 程 中 会 
查找 这 个 接口 。 这 个 接口 的 定义 如 下 : 


namespace Microsoft.AspNetCore.Mvc.Filters { 


public interface IOrderedFilter : IFilterMetadata { 


int Order { get; } 
} 





} 


Order 属 性 会 返回 一 个 int 值 ， 较 低 的 值 将 通知 
MVC 在 执行 具有 较 高 顺序 值 的 自选 之 前 应 用 过 泪 
器 。convenience 属 性 已 经 实现 了 IOrder 值 ， 代 人 码 清 
单 19-36 为 应 用 于 Home 控 制 器 的 过 滤器 设置 了 Order 
属性 。 








fe ” 示 


TypeFilter 和 ServiceFilter 特 性 还 实现 了 
IOrderedFilter 接 口 ， 这 意味 看 可 以 在 使 用 依赖 注入 
时 更 改过 滤器 的 执行 顺序 。 





代码 清单 19-36 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 设置 过 滤器 的 执行 顺序 





using Filters.Infrastructure; 
using Microsoft.AspNetCore.Mvc; 


namespace Filters.Controllers { 


[Message("This is the Controller-Scoped Filter", Or 


der = 10)] 
public class HomeController : Controller { 


[Message("This is the First Action-Scoped Filte 
r", Order = 1)] 

[Message("This is the Second Action-Scoped Filt 
er", Order = -1)] 

public ViewResult Index() => View("Message", 

"This is the Index action on the Home contr 
oller"); 
} 


Pe 


DEVEAS Order th ALLAH, eR TE 
HA ERA IAT INP EN AE H E Pe AZ. DF EE 
器 的 有 用 方法 (尽管 也 可 以 在 创建 全 局 过 滤器 时 设 
置 执行 顺序 ) 。 如 果 运 行 示 例 应 用 程序 ， 你 将 看 到 
消息 的 输出 顺序 已 更 改 ， 以 反映 新 设置 的 优先 级 。 








Result:This is the Second Action-Scoped Filter 
Result:This is the Globally-Scoped Filter 
Result:This is the First Action-Scoped Filter 
Result:This is the Controller-Scoped Filter 


After Result:This is the Controller-Scoped Filter 
After Result: This is the First Action-Scoped Filter 
After Result: This is the Globally-Scoped Filter 
After Result: This is the Second Action-Scoped Filter 





19.11 小 结 


本 章 讲 述 了 如 何 将 交叉 关注 问题 的 逻辑 封装 为 
过 滤 左 ， 展 示 了 各 种 不 同 的 过 滤 右 以 及 它们 的 实现 
方法 。 此 外 ， 本 章 还 讨论 了 如 何 将 过 滤器 作为 属性 
应 用 于 控制 器 和 操作 方法 ， 以 及 如 何 将 它们 作为 全 








局 过 滤 堪 来 应 用 。 下 一 章 将 展示 如 何 使 用 控制 喜来 
创建 Web 服 务 。 


第 20 音 API 控制 器 


并 非 所 有 控制 器 都 用 于 同 客 户 端 及 送 HTML 文 
档 ， API 控 制 器 用 于 提供 对 应 用 程序 数据 的 访 
问 。 这 是 以 前 通过 单独 的 Web API 框 架 提供 的 功 
能 ， ans 已 经 集成 到 ASP.NET Core MVC. A 
章 将 解释 API 控 制 器 在 Web 应 用 程序 中 的 作用 ， 描 
述 它 们 解决 的 问题 ， 并 演示 如 何 创建 、 测 试 和 使 用 
它们 。 表 20-1 描 述 了 API 控 制 器 的 背景 。 


4220-1 _ API 控制 器 的 背景 











空 制 器 与 常规 控制 器 相似 ， 除 了 它们 的 操作 方法 产生 的 响应 是 发 送 到 客户 


端的 数据 对 象 而 不 是 HTML 标 记 之 外 























，| API 控 制 器 允许 客户 端 访 问 应 用 程序 中 的 数据 ， 而 不 会 收 到 将 内 容 呈 现 给 用 户 



















































































API 控 制 器 
hth te 所 需 的 HIML 标 记 。 并 不 是 所 有 客户 端 都 是 浏览 器 ， 也 并 不 是 所 有 客户 端 都 
用 ? 向 用 户 显示 数据 。API 控 制 器 使 应 用 程序 变 成 开放 的 ， 可 以 支持 新 类 型 的 客户 





端 或 由 第 三 方 开 发 的 客户 端 

















API 控 制 器 可 像 常规 HTML 控 制 器 一 样 使 用 











使 用 API 控 
Bll AS ES Ay 
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局 限 


TE? 





H 
是 否 有 其 


他 的 蔡 代 “| 不 必 在 项 目 中 使 用 API 控 制 器 ， 但 这 样 做 可 以 增加 平台 对 客户 端的 价值 
方案 ? 





























表 20-2 列 出 了 本 章 要 介绍 的 操作 。 
表 20-2 “本章 要 介绍 的 操作 


代码 清单 























应 用 程序 数据 的 访 | aprile pp 




















使 用 Ajax 查 询 ， 直 接 使 用 浏览 器 API 或 通过 
库 ， 比 如 jQuery 









































从 API 控 秆 























履 盖 内 容 协商 过 程 使 用 Produces 属 性 一 代码 清单 20- 




















许 客户 端 通过 URL 中 指 | 在 Startup 类 中 添加 格式 化 映射 ， 添 加 捕获 数据 | 代码 清单 20-17 
定 的 数据 格式 覆盖 Accept | 格式 的 片段 变量 ， 并 可 选择 应 用 FormatFilter | 和 代码 清单 20- 
标 头 特性 18 





























启用 HttpNotAcceptableOutputFormatter 格 式 化 | 代码 清单 20-19 
程序 并 设置 RespectBrowserAcceptHeader 配 置 ”| 和 代码 清单 20- 
属性 20 





为 内 容 协商 过 程 提供 全 面 


se ee 


支持 















































使 用 不 同 的 操作 方法 接收 
不 同 格式 的 数据 





使 用 Consumes 属 性 代码 清单 20-21 








20.1 准备 示例 项 目 


对 于 本 章 ， 使 用 ASP.NET Core Web 
Application (.NET Core) 模板 创建 一 个 名 为 
ApiControllers 的 Empty 项 目 。 


20.1.1 创建 模型 和 存储 库 


首先 创建 Models 文 件 夹 ， 还 加 一 个 名 为 


Reservation.cs 的 类 文件 ， 并 用 它 定 义 如 代码 清单 20- 
1 所 示 的 模型 类 。 


代码 清单 20-1 Models 文 件 夹 下 的 Reservation.cs 文 件 的 内 容 


namespace ApiControllers.Models { 


public class Reservation { 
public int ReservationId { get; set; } 


public string ClientName { get; set; } 
public string Location { get; set; } 





还 将 一 个 名 为 IRepository.cs 的 文件 添加 到 
Models 文 件 夹 中 ， 并 用 它 定义 模型 存储 库 的 接口 ， 
如 代码 清单 20-2 所 示 。 








代码 清 蛙 20-2 Models 文 件 夹 下 的 IRepository.cs 文 件 的 内 容 





using System.Collections.Generic; 


namespace ApiControllers.Models { 
public interface IRepository { 


IEnumerable<Reservation> Reservations { get; } 


Reservation this[int id] { get; } 


Reservation AddReservation(Reservation reservat 
ion); 

Reservation UpdateReservation(Reservation reser 
vation); 


void DeleteReservation(int id); 


} 





添加 一 个 名 为 MemoryRepository.cs 的 类 文件 到 
Models 文 件 夹 中 ， 并 用 它 定义 IRepository 接 口 的 非 
持久 性 实现 ， 如 代码 清单 20-3 所 示 。 





代码 清单 20-3 ”Models 文 件 夹 下 的 MemoryRepository.cs 文 件 的 


内 容 





using System.Collections.Generic; 


namespace ApiControllers.Models { 


public class MemoryRepository : IRepository { 
private Dictionary<int, Reservation> items; 


public MemoryRepository() { 
items = new Dictionary<int, Reservation>(); 
new List<Reservation> { 


new Reservation { ClientName = "Alice", 
Location = "Board Room" }, 


new Reservation { ClientName = "Bob", L 


ocation = "Lecture Hall" }, 
new Reservation { ClientName = "Joe", L 
ocation = "Meeting Room 1" } 
}.ForEach(r => AddReservation(r) ); 


} 


public Reservation this[int id] => items.Contai 
nsKey(id) ? items[id] : null; 


public IEnumerable<Reservation> Reservations => 
items.Values; 


public Reservation AddReservation(Reservation r 
eservation) { 
if (reservation.ReservationId == @) { 
int key = items.Count; 
while (items.ContainsKey(key)) { key++; 
}; 
reservation.ReservationId = key; 
} 
items[reservation.ReservationId] = reservat 
ion; 
return reservation; 


} 


public void DeleteReservation(int id) => items. 
Remove(id); 


public Reservation UpdateReservation(Reservatio 
n reservation) 
=> AddReservation(reservation); 





存储 库 在 实例 化 时 会 创建 一 组 简单 的 模型 对 
象 ， 并 且 由 于 没有 持久 存储 ， 因 此 当 应 用 程序 俘 目 
或 重新 启动 时 ， 任 何 更 改 都 将 丢失 。 有 关 如 何在 
SportsStore 示 例 应 用 程序 中 创建 持久 存储 库 的 示 
fil, WARR. 























20.1.2 JÆ P42 Hill 5 A 4 A 


在 本 章 的 后 面部 分 ， 将 创建 REST 控 制 器 ， 但 
在 准备 时 ， 需 要 创建 常规 控制 器 ， 从 而 为 以 后 的 例 
子 提供 基础 。 创 建 Controllers 文 件 来， 并 添加 一 个 
名 为 HomeController.cs 的 文件 ，Home 控 制 右 的 定义 
如 代码 清单 20-4 所 示 。 


代码 清单 20-4 ”Controllers 文 件 夹 下 的 HomeController.cs 文 件 的 
内 容 





using Microsoft.AspNetCore.Mvc; 
using ApiControllers.Models; 


namespace ApiControllers.Controllers { 


public class HomeController : Controller { 
private IRepository repository { get; set; } 


public HomeController(IRepository repo) => repo 
sitory = repo; 


public ViewResult Index() => View(repository.Re 
servations); 


[HttpPost | 


public IActionResult AddReservation(Reservation 
reservation) { 


repository .AddReservation(reservation) ; 
return RedirectToAction("Index") ; 








Home# ill 45 xe X J Index#eyF, XMH ENT 
的 默认 值 ， 用 于 演 染 数据 模型 。 另 外 ， 还 定义 了 
AddReservation 操 作 ， 但 只 能 用 于 接收 HTTP POST 
请 求 ， 并 且 将 用 于 从 用 户 接 收 表 单数 据 。 这 些 操 作 
遵循 第 17 章 中 描述 的 Post/Redirect/Get 模 式 ， 这 样 重 
新 加 载 网 页 时 束 不 会 创建 重复 提交 的 表单 。 








创建 布局 ， 以 便 可 以 将 HTML 内 容 与 HTML 文 





档 标 头 分 离 出 来 ， 这 将 简化 本 草 稍 后 部 分 的 一 些 更 
改 。 创 建 Views/Shared 文 件 夹 ， 添 加 一 个 名 为 
_Layout.cshtml 的 布局 文件 ， 并 添加 代码 清单 20-5 所 
示 的 标记 。 


代码 清单 20-5 Views/Shared 文 件 严 下 的 _Layout.cshtml 文 件 的 


内 容 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>RESTful Controllers</title> 


<link asp-href-include="1lib/bootstrap/dist/css/*.mi 
n.css" rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
@RenderBody() 
</body> 
</html> 





接 下 来 ， 创 建 Yiews/Home 文 件 夹 ， 添 加 一 个 
名 为 Index.cshtml 的 视图 文件 ， 并 添加 代码 清单 20-6 
所 示 的 内 容 。 


代码 清单 20-6 Views/Home 文 件 夹 下 的 Views.cshtml 文 件 的 内 


P 


谷 





@model IEnumerable<Reservation> 
@{ Layout = " Layout"; } 


<form id="addform" asp-action="AddReservation" method=" 
post"> 
<div class="form-group"> 
<label for="ClientName">Name:</label> 
<input class="form-control" name="ClientName" / 


</div> 
<div class="form-group"> 
<label for="Location">Location:</label> 
<input class="form-control" name="Location" /> 
</div> 
<div class="text-center panel-body"> 
<button type="submit" class="btn btn-sm btn-pri 
mary" >Add</button> 
</div> 
</form> 


<table class="table table-sm table-striped table-border 
ed m-2"> 
<thead><tr><th>ID</th><th>Client</th><th>Location</ 
th></tr></thead> 
<tbody> 
@foreach (var r in Model) { 
<tr> 
<td>@r.ReservationId</td> 
<td>@r.ClientName</td> 
<td>@r.Location</td> 
</tr> 


} 
</tbody> 
</table> 


这 种 强 类 型 视图 接收 一 系列 Reservation 对 象 作 
为 模型 ， 并 使 用 Razor foreach ARHAR. A 
外 ， 还 有 一 个 表单 ， 己 配置 为 将 POST 请 求 发 送 到 
AddReservation 操 作 。 








本 章 中 的 示例 依赖 于 Bootstrap CSS 包 。 要 将 
Bootstrap 包 添加 到 项 目 中 ， 可 使 用 Bower 
Configuration File 模 板 在 项 目的 根 目录 中 创建 
bower.json 文 件 ， 并 将 Bootstrap 包 添加 到 
dependencies 部 分 ， 如 代码 清单 20-7 所 示 。 


代码 清单 20-7 在 bower.json 文 件 中 添加 Bootstrap 包 


{ 
"name": "asp.net", 
"private": true, 
"dependencies": { 
"bootstrap": "4.0.0-alpha.6" 


} 


} 








接 下 来 ， 在 Views 文 件 夹 中 创建 
_ViewImports.cshtml 文 件 ， 并 在 其 中 设置 用 于 Razor 
视图 的 内 置 标签 助手 ， 然 后 导入 模型 命名 空间 ， 如 
代码 清单 20-8 所 示 。 








代码 清单 20-8 ” Views 文件 夹 下 的 _ViewImports.cshtml 文 件 的 内 


IP 


谷 


@addTagHelper *，Microsoft.AspNetCore.Mvc.TagHelpers 

为 了 启用 开发 所 需 的 MVC 框 架 和 中 间 件 ， 对 
Startup 类 进行 修改 ， 如 代码 清单 20-9 所 示 。 另 外 ， 
还 使 用 AddSingleton 方 法 为 模型 存储 库 设 置 了 服务 
PRINT o 





代码 清单 20-9 在 ApiControllers 文 件 夹 下 的 Startup.cs 文 件 中 局 
用 中 间 件 





using System; 
using System.Collections.Generic; 
using System.Ling; 


using System.Threading.TasKs ; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using ApiControllers.Models; 


namespace ApiControllers { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<IRepository, MemoryRe 
pository>(); 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 
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本 章 中 的 一 些 示 例 需 要 通过 手动 输入 URL 进 行 
测试 。 为 了 摘 述 更 容易 ， 下 面 设置 用 于 接收 HTTP 


请 求 的 端口 。 从 Visual Studio’) Project P X% F% 
ApiControllers Properties， 显 示 Debug 选 项 卡 ， 将 
App URL 的 值 更 改 为 http://localhost:7000/， 如 图 20- 
1 所 示 。 确 保 在 设置 痛 口 号 后 保存 更 改 。 





Enable SSL 


(V) Enable Anonymous Authentication 


图 20-1 设置 应 用 程序 URL 


司 动 应 用 程序 ， 填 与 表单 ， 然 后 单 击 Add 鬼 
钮 ， 应 用 程序 将 为 模型 添加 新 的 数据 ， 如 图 20-2 所 
示 。 但 你 对 存储 库 所 做 的 更 改 不 会 持久 保留 ， 在 应 
用 程序 集 止 或 重新 局 动 时 将 会 丢失 。 











图 20-2 ”启动 示例 应 用 程序 
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这 个 示例 应 用 程序 是 经 典 的 Web 应 用 程序 。 示 
例 应 用 程序 中 的 所 有 逻辑 都 存在 于 服务 圳 上 ， 包 侣 
在 C# 尖 中 ， 这 使 得 它们 易于 管理 、 测 试 和 维护 。 但 
征 ， 以 这 种 方式 设计 的 应 用 程序 在 速度 、 效 率 和 开 
放 性 方面 可 能 会 有 严重 的 缺陷 。 





20.2.1 速度 问题 





此 时 ， 示 例 应 用 程序 是 同步 的 Web 应 用 程序 。 
当 用 户 单 击 Add 按 钮 时 ， 浏 览 器 将 POST 请 求 发 送 到 


服务 茧 ， 等 街 啊 应 ， 然 后 呈现 接收 到 的 HTML。 在 
此 期 间 ， 用 户 无 法 做 任何 事情 ， 只 能 等 待 。 当 浏览 
船 和 服务 亏 位 于 同一 合计 算 机 上 时 ， 等 竺 时间 在 开 
发 过 程 中 是 不 可 察觉 的 ， 然而， 部 绪 的 应 用 程序 受 
实际 容量 和 延迟 的 限制 ， 并 且 同 步 应 用 程序 要 求 用 
户 等 待 啊 应 的 时 间 可 能 很 长 。 

















同步 应 用 程序 不 会 总 有 速度 问题 。 例 如 ， 如 果 
你 正在 编写 一 个 线路 业务 应 用 程序 ， 用 于 单个 位 
置 ， 其 中 所 有 客户 站 都 通过 快速 可 靠 的 LAN 连 接 ， 
那么 不 会 有 需要 解决 的 问题 。 如 条 你 正在 基础 设施 
沽 弱 的 地 区 为 移动 客户 奖 编 写 应 用 程序 ， 则 速度 问 
题 可 能 很 严重 。 





二 


提 ” 示 


某 些 浏览 右 可 让 你 模拟 不 同类 型 的 网 络 ， 这 可 
以 作为 有 用 的 工具 ， 用 于 查看 用 户 是 人 否 可 能 接受 将 
同步 应 用 程序 用 于 各 种 场景 。 例 如 ，Google 
Chrome 提 供 了 名 为 网 络 限 制 的 功能 ， 可 按 F12 键 ， 
在 开发 人 员工 具 的 Network 部 分 找到 。 有 一 系列 预 
定义 的 网 络 可 用 ， 也 可 以 通过 指定 上 传 /下 载 速 率 和 
延迟 来 创建 自己 的 网 络 。 











20.2.2 ”效率 问题 


效率 问题 源 于 同步 Web 应 用 程序 将 浏览 器 视 为 
仅 用 于 显示 服务 器 发 送 的 HTML 文 档 的 HTML 呈 现 
引擎 的 方式 。 


当 用 户 首 先 请 求 示 例 应 用 程序 的 默认 URL 时 ， 





发 回 的 HTML 文 档 将 包 舍 浏览 卉 需要 显示 应 用 程序 
内 容 的 所 有 信息 ， 包 括 以 下 信息 : 


。 内 容 依赖 于 Bootstrap CSS 文 件 ， 如 果 绥 存 副本 
不 可 用 ， 吏 应 该 下 载 该 文件 。 

e。 NAA HE N A AddReservation#i/E Rik 
POST 请 求 的 表单 。 

。 内 容 包 含 一 个 表格 ， 这 个 表格 包含 3 行 。 





示例 应 用 程序 很 简单 ， 初 始 请 求 导致 服务 器 问 
客户 端 发 送 约 1.3KB 数 据 。 但 是 ， 当 用 户 提 交 表 单 
时 ， 客 户 端 将 再 次 重 定向 到 Index 操 作 ， 这 将 导致 另 
外 1.3KB 数 据 反 映 单 个 表 行 的 添加 。 浏 览 器 已 经 呈 
现 了 表单 和 表格 ， 但 是 这 些 表 单 和 表格 都 被 丢弃 ， 
并 被 蔡 换 为 在 很 大 程度 上 内 容 相同 的 全 新 表示 形 
sate 














你 可 能 认为 1.3KB 数 据 并 不 多 ， 但 是 ， 如 宁 考 
展 到 有 用 内 容 与 重复 内 容 的 比例 ， 你 将 看 到 发 送 到 


浏览 带 的 绝 大 多 数 数据 被 当 费 了 了。 示例 应 用 程序 是 
故意 简化 的 ;很 少 有 应 用 程序 需要 这 么 少 的 HTML 
标记 ， 并 且 随 痢 应 用 程序 复杂 性 的 增加 ， 重 复 内 容 
的 数量 将 显著 增加 。 














20.2.3 ”开放 性 问题 


传统 Web 应 用 程序 提出 的 最 终 问题 是 设计 是 关 
闭 的 ， 这 意味 看 模型 中 的 数据 只 能 通过 Home 控 制 
夯 提 供 的 操作 进行 访问 。 当 需要 在 另 一 个 应 用 程序 
中 使 用 确 层 数据 时 ， 封 财 的 应 用 程序 成 为 问题 ， 特 
别 是 当 应 用 程序 由 不 同 的 团队 甚至 不 同 的 组 织 开 友 
时 。 开 友人 员 经 向 认 为 ， 应 用 程序 的 价值 在 于 为 用 
尸 提供 互 动 ， 主 要 原因 在 于 这 些 是 我 们 伦 时 间 思 苑 
和 写作 的 部 分 。 一 旦 建立 了 应 用 程序 并 具有 活跃 的 
用 户 群 ， 应 用 程序 包含 的 数据 往往 将 变 得 重要 。 


























20.3 REST 和 API 探 制 器 


API 控 制 右 是 MVC 控 制 器 ， 负 责 提供 对 应 用 程 
序数 据 的 访问 ， 而 不 将 它们 封装 在 HTML 中 。 这 人 允 
许 检 索 或 修改 模型 中 的 数据 ， 而 不 必 使 用 常规 控制 
器 提供 的 操作 ， 例 如 示例 中 的 Home 控 制 器 。 











从 应 用 程序 传递 数据 的 常见 方法 是 使 用 称 为 
REST 的 表示 状态 传输 模式 。 没 有 关于 REST 的 详细 
规范 ， 这 导致 许多 不 同 的 方法 包含 在 REST 风 格 之 
下 。 但 是 ， 这 在 客户 端 Web 应 用 程序 开发 中 是 有 用 
的 。 








Web 服 务 的 核心 前 提 是 采用 HITTP 的 特征 ， 以 
便 请 求 方法 “也 称 为 谓词 ) 指定 服务 器 执行 的 操 
作 ， 请 求 URL 指 定 一 个 或 多 个 数据 对 象 ， 以 应 用 操 
作 。 


作为 示例 ， 下 面 是 一 个 可 能 在 示例 应 用 程序 中 
引用 的 特别 预 留 的 URL: 


/api/reservations/1 


URL 的 第 一 部 分 一 一 api 用 于 将 应 用 程序 的 数据 
部 分 与 生成 HIML 的 标准 控制 右 分 离 。 下 一 部 分 
reservations 指 示 将 要 操作 的 对 象 集合 。 最 后 一 
部 分 一 一 1 指定 对 象 集合 中 的 单个 对 象 。 在 示例 应 
用 程序 中 ， 这 了 吏 是 唯一 标识 对 象 并 将 在 URL 中 使 用 
的 ReservationId 属 性 值 。 




















请 识别 对 象 的 URL 与 HTTP 方 法 组 合 以 指定 操 
作 。 表 20-3 列 出 了 常用 的 HTTP 方 法 以 及 与 示例 
URL 结 合 使 用 的 方法 ， 还 列 出 了 每 个 方法 和 URL 组 
合 的 请 求 及 啊 应 中 包含 哪些 数据 《有 效 负 载 ) 的 详 
细 人 信息。 处理 这 些 请 求 的 API 控 制 器 使 用 响应 状态 
代码 来 报告 请 求 的 结果 。 





表 20-3 ” 弟 用 的 HTTP 方 法 以 及 与 示例 UREL 结 合 使 用 的 方法 














检索 所 有 对 包含 预 留 对 象 的 完整 集合 


检索 ReservationId 为 1 . 
/api/reservations/1 包含 指定 的 Reservation 对 象 
的 Reservation 对 象 








包含 创建 Reservation 对 象 所 需 的 其 他 属 
新 的 Reservation 








/api/reservation 性 的 值 。 响 应 中 包含 存储 的 对 象 ， 确 保 
客户 端 接收 保存 的 数据 




















2 包含 更 改 指定 Reservation 对 象 的 属性 所 
更 新 现 有 的 
/api/reservation 需 的 值 。 响 应 中 包含 存储 的 对 象 ， 确 保 
Reservation 对 象 d 
客户 端 接收 保存 的 数据 











修改 现 有 的 

Reservation 对 象 ， 该 | 包含 一 组 应 该 应 用 于 指定 的 Reservation 
对 象 的 ReservationId | 对象 的 修改 ， 是 对 更 改 已 应 用 的 确认 
为 1 


删除 ReservationId 为 1|、 、、 
DELETE | /api/reservation/1 请 求 或 响应 中 没有 有 效 负载 
的 Reservation 对 象 


这 循 REST 约 定 不 是 必需 的 ， 但 这 么 做 有 助 于 
使 应 用 程序 更 容易 使 用 ， 因 为 许多 已 建立 的 web 应 
用 程序 广泛 采用 了 相同 的 方法 。 








/api/reservation/1 



































20.3.1 创建 API 控 制 嚣 


创建 API 控 制 句 的 过 程 基 于 创建 标准 控制 右 的 
方法 ， 还 有 一 些 其 他 功能 可 以 帮助 指定 提供 给 客户 
问 的 API。 为 了 演示 ， 添 加 一 个 名 为 
ReservationController.cs 的 类 文件 到 Controllers 文 件 
玉 中 ， 并 用 它 定义 代码 清单 20-10 所 示 的 类 。 稍 后 
将 介绍 这 个 控制 颖 提供 的 功能 。 





代码 清单 20-10 ”Controllers 文 件 夹 下 的 ReservationController.cs 
文件 的 内 容 





using System.Collections.Generic; 
using Microsoft.AspNetCore.Mvc; 

using ApiControllers.Models; 

using Microsoft.AspNetCore.JsonPatch; 


namespace ApiControllers.Controllers { 


[Route("api/[controller]") ] 
public class ReservationController : Controller { 
private IRepository repository; 


public ReservationController(IRepository repo) 
=> repository = repo; 


[HttpGet ] 
public IEnumerable<Reservation> Get() => reposi 


tory.Reservations; 


[HttpGet ("{id}") ] 
public Reservation Get(int id) => repository[id 


] ; 


[HttpPost ] 
public Reservation Post([FromBody] Reservation 
res) => 
repository.AddReservation(new Reservation { 
ClientName = res.ClientName, 
Location = res.Location 


Ps 


[HttpPut ] 
public Reservation Put([FromBody] Reservation r 
es) => 
repository .UpdateReservation(res) ; 


[HttpPatch("{id}") ] 
public StatusCodeResult Patch(int id, 
[ FromBody | JsonPatchDocument<Reservation 
> patch) { 
Reservation res = Get(id); 
if (res != null) { 
patch.ApplyTo(res); 
return Ok(); 
} 


return NotFound(); 


} 


[HttpDelete("{id}") ] 
public void Delete(int id) => repository.Delete 
Reservation(id); 
} 
} 


cr 


提 示 


请 记 住 ， 控 制 右 类 可 以 在 项 目 中 的 任何 位 置 进 
行 定 义 ， 而 不 仅仅 是 在 Controllers 文 件 夹 中 。 对 于 
大 型 和 复杂 项 目 ， 与 前 规 HTML 控 制 右 分 开 ， 将 定 
义 的 API 控 制 器 完全 放置 在 子 文件 夹 甚至 单独 的 文 
件 夹 中 是 有 帮助 的 。 





API 控 制 占 的 工作 方式 与 常规 控制 费 相 同 ， 这 
意味 着 可 以 创建 POCO 控制 医 ， 或 者 从 控制 右 基 类 
派生 类 ， 这 样 可 以 更 方便 地 访问 请 求 上 下 文 数据 。 


适应 REST 模 式 


REST 模 式 在 如 何 将 Web 应 用 程序 API 呈 现 给 客 
户 端 方面 ， 在 一 定 程度 上 鼓励 教条 主义 。REST 不 
是 标准 的 甚至 不 是 定义 明确 的 模式 ， 但 REST 提 供 
了 一 些 有 用 的 方法 ， 可 以 让 ASP.NET Core MVC 应 
用 程序 更 容易 采用 ， 但 是 有 一 种 趋势 会 刺激 那些 对 
作为 REST 计 数 有 固定 观点 的 程序 员 。 





在 表 20-3 中 ， 为 POST 和 PUT 操作 列 出 的 URL 不 
唯一 标识 资源 ， 有 些 人 认为 这 是 一 个 基本 的 REST 
特性 。 在 POST 操作 的 情况 下 ， 预 留 对 象 的 唯一 标 
识 符 由 模型 分 配 ， 这 意味 着 客户 端 无 法 将 其 作为 
URL 的 一 部 分 提供 。 在 PUT 操 作 的 情况 下 ， 第 26 章 
描述 的 MVC 模 型 绑 定 功能 是 应 用 代码 清单 20-10 中 
的 FromBody 特 性 的 原因 ， 使 得 从 请 求 体 接收 到 要 








修改 的 Reservation 对 象 的 详细 信息 更 加 容易 。 所 
以 ， 这 就 是 Reservation 控 制 器 期 望 找到 
ReservationId 值 的 地 方 ， 该 值 用 于 标识 要 修改 的 模 
型 对 象 。 





与 所 有 模式 一 样 ，REST 模式 是 起 点 ， 这 不 是 
必须 不 惜 一 切 代价 遵守 的 严格 标准 ， 唯 一 重要 的 是 
编写 可 以 被 理解 、 测 试 和 维护 的 代码 。 通 过 适应 
MVC 应 用 程序 的 性 质 和 存储 库 的 设计 可 造 残 更 简单 
的 应 用 程序 ， 同 时 仍然 为 客户 提供 有 用 的 API。 建 
议 将 模式 视 为 按 上 自己 需求 所 选 的 指导 原则 ， 这 与 
REST 模 式 一 样 ， 对 于 MVC 本 喘 也 是 如 此 。 





1. 定义 路 由 


到 达 API 控 制 器 的 路 由 只 能 使 用 Route 特 性 进行 


定义 ， 无 法 在 Startup 类 的 应 用 程序 配置 中 定义 。 
API 控 制 硕 的 惯 及 绥 为 api 的 路 由 ， 后 跟 控 
制 蕉 的 名 称 ， 以 便 通 过 URL 
如 代码 清单 20-10 所 示 的 ReservationController 控 制 
ax, UN PATA: 











/api/reservation 访 问 


[Route("api/[controller]")] 


public class ReservationController : Controller { 





2. 声明 依赖 关系 








API 控 制 右 以 与 第 规 控制 右 相 同 的 方式 实例 
化 ， 这 意味 看 它们 可 以 声明 将 使 用 service provider 
解析 的 依赖 关系 。ReservationController 类 在 
IRepository 接 口上 声明 了 构造 函数 依赖 关系 ， 它 将 
锌 解析 为 提供 对 模型 中 数据 的 访问 : 











public ReservationController(IRepository repo) => repos 
itory = repo; 


3. 定义 操作 方法 


每 个 操作 方法 都 使 用 一 个 特性 进行 装饰 ， 该 特 
性 指定 了 能 够 接受 的 HTTP 方 法 ， 如 下 所 示 : 


[HttpGet ] 


public IEnumerable<Reservation> Get() => repository.Res 
ervations; 








HttpGet 特 性 是 用 于 将 对 操作 方法 的 访问 限制 为 
具有 特定 HTTP 方 法 或 谓词 的 请 求 集合 之 一 。HTTP 
特性 参见 表 20-4。 











表 20-4 HTTP 特 性 












































使 用 GET 方 法 的 HTTP 请 求 调用 









































日 使 用 POST 方 法 的 HTTP 请 求 调用 









































HttpDelete 指定 只 能 由 使 用 DELETE 方 法 的 HTTP 请 求 调用 





























能 由 使 用 PUT 方法 的 HTTP 请 求 调 用 























间 定 只 能 由 使 用 PATCH 方法 的 HTTP 请 求 调用 



































外 由 使 用 HEAD 方 法 的 HTTP 请 求 调用 














通过 将 路 由 片段 作为 HITP 方 法 特性 的 参数 包 
括 在 内 ， 可 以 进一步 细 化 路 由 ， 如 下 所 示 : 


[HttpGet("{id}")] 


public Reservation Get(int id) => repository[id]; 





路 由 请 段 {id} 可 与 应 用 于 控制 器 的 Route 特性 定 
义 的 路 由 A 的 约束 相 结 合 。 在 这 
种 情况 下 ， 这 意味 着 可 以 通过 发 送 一 个 URL 匹 
配 /api/reservations/{id} 路 由 模式 的 GET 请 求 来 执行 
此 操作 ， 然 后 使 用 id 片段 来 标识 应 该 检索 的 
Reservation 对 象 。 











请 注意 ， 为 API 控 制 絮 生成 的 路 由 不 包含 
{action} 片段 变量 ， 这 意味 着 操作 方法 的 名 称 不 是 
目标 特定 方法 所 需 URL 的 一 部 分 。API 控 制 器 中 的 
所 有 操作 都 通过 相同 的 基本 URL 例 
如 /api/reservation ) 达成 ，HITP 方 法 和 可 选 参数 斤 
段 可 用 于 区 分 它们 。 








4. 定义 操作 结果 


API 控 制 器 的 操作 方法 不 依赖 于 ViewResult 对 
象 来 呈现 结果 ， 因 此 在 传递 数据 时 不 需要 视图 。 
API 控 制 右 的 操作 方法 直接 返回 数据 对 象 ， 如 下 所 
示 : 








[HttpGet] 


public IEnumerable<Reservation> Get() => repository.Res 
ervations; 





以 上 操作 返回 一 系列 Reservation 对 象 ， 并 使 


MVC 负 责 将 其 序列 化 为 可 由 客户 端 处 理 的 格 却 。 
20.4 节 将 更 详细 地 解释 这 个 过 程 。 





自 定 义 API 结 果 


API 控 制 器 最 有 吸引 力 的 是 可 以 从 操作 方法 返 
回 C# 对 象 ， 并 让 MVC 弄 清楚 如 何 处 理 它 们 。MVC 
很 擅长 处 理 ， 例 如 ， 如 采 从 API 控 制 右 的 操作 方法 
返回 null， 客 户 端 将 被 友 送 204-No Content 吧 应 。 


但 API 控 制 占 也 可 以 使 用 第 规 控 制 闫 的 功能 ， 
这 意味 着 可 以 通过 从 指定 要 友 送 何 种 结果 的 操作 方 
法 返回 IActionResult 来 窗 新 默认 行为 。 作 为 示例 ， 
这 里 是 来 目 示 例 控 制 器 的 操作 方法 的 实现 ， 示 例 控 
制 恬 回 与 模型 中 的 对 象 匹配 失败 的 得 询 发 送 404- 
Not Found 啊 应 : 








[HttpGet("{id}") ] 

public IActionResult Get(int id) { 
Reservation result = repository[id]; 
if (result == null) { 


return NotFound(); 
} else { 
return Ok(result) ; 





如 果 指 定 ID 的 存储 库 中 没有 对 象 ， 那 么 将 调用 
NotFound 方 法 ， 访 方法 将 创建 一 个 NotFoundResult 
对 象 ， 这 反 过 来 又 导致 友 送 到 客户 疹 的 404-Not 
Found 啊 应 。 如 果 存 储 库 中 有 对 象 ， 就 调用 Ok 方法 
来 创建 ObjectResult 对 象 。Ok 方 法 允许 在 返回 
IActionResult 的 操作 中 同 客 户 端 及 送 对 象 ， 如 第 17 
草 所 述 。 通 第 不 需要 居 兰 默认 的 API 探 制 器 啊 应 ， 
但 是 如 采 需 要 ， 则 可 以 使 用 全 部 action 结 采 。 














20.3.2 ”测试 API 控 制 器 


这 里 有 很 多 可 用 于 帮助 测试 Web 应 用 程序 API 
的 工具 。 好 的 例子 包括 Fiddler， 它 是 一 个 独立 的 
HTTP 调 试 工具 ; 还 有 Swashbuckle， 它 是 一 个 
NuGet 软 件 包 ， 可 将 摘要 页 面 添加 到 描述 其 API 操 作 
并 允许 对 它们 在 应 用 程序 中 进行 测试 。 











最 简单 的 测试 API 控 制 器 的 方法 是 使 用 
PowerShell， 这 样 可 以 轻松 地 从 Windows 命 令 行 创 
建 HTTP 请 求 ， 并 且 可 以 让 你 专注 于 API 操 作 的 结 
R, MAER. Powershell twi F 
Windows， 但 现在 也 可 用 于 Linux 系 统 和 macOS 。 


下 面 的 内 容 将 告诉 你 如 何 使 用 PowerShell 来 测 
试 由 Reservation 控 制 右 提供 的 每 个 操作 。 可 以 打开 
一 个 新 的 PowerShell 窗 口 来 运行 测试 命令 或 使 用 
PowerShell 的 Visual Studio 包 管理 需 控 制 台 窗口 。 


1. 测试 GET 操 作 


要 测试 Reservation API 控 制 器 提供 的 GET 操 
作 ， 请 从 Visual Studio 的 Debug 深 单 中 选择 Start 
Without Debugging 以 启动 应 用 程序 ， 然 后 等 待 ， 直 
到 看 到 Home 控 制 器 提供 的 同步 啊 应 。 应 用 程序 运 
行 后 ， 打 开 PowerShell 窗 口 并 键入 以 下 命令 : 


Invoke-RestMethod http://localhost: 7000/api/reservation 
-Method GET 


上 述 命令 使 用 Invoke-RestMethod PowerShell 
cmdlet 将 GET 请 求 发 送 到 URL 
结果 被 解 林 和 格式 化 ， 以 使 数据 容易 疯 读 ， 如 下 所 


on 


ZN: 











/api/reservation 。 


reservationId clientName location 


@ Alice Board Room 
1 Bob Lecture Hall 
2 Joe Meeting Room 1 





服务 器 使 用 模型 中 包含 的 Reservation 对 象 的 
JSON 表 示 形 式 来 啊 应 GET 请 求 ，Invoke- 


RestMethod cmdlet 以 表格 形式 显示 。 


理解 JSON 


JSON 〈JavaScript 对 象 表示 法 ) 已 成 为 Web 应 
用 程序 的 标准 数据 格式 。JSON 之 所 以 变 得 流行 ， 
是 因为 它 简 单 且 易 于 使 用 。 由 于 JSON 格 式 与 
JavaScript 代 码 中 的 文字 对 象 类 似 ， 因 此 JavaScript 
代码 中 的 JSON 数 据 处 理 尤 其 容易 。 现 代 浏览 需 提 
供 生 成 和 解析 JSON 数 据 的 内 置 文 持 ， 流 行 的 
JavaScript 库 〈 如 jQuery) 会 目 动 与 JSON 互 相 转 
换 。 虽 然 JSON 从 JavaScript 演 变 而 来 ， 但 它 的 结构 
很 容易 让 C# 开 及 人 员 了 阅读 和 理解 。 举 例 来 说， 以 下 
是 示例 应 用 程序 中 API 控 制 右 的 啊 应 : 











[{"reservationId":0,"clientName":"“Alice","location":"Bo 
ard Room"}, 


{"reservationiId":1,"clientName":"Bob", "location": "Lect 
ure Hall"}, 

{"reservationId":2,"clientName":"Joe", "location": "Meet 
ing Room 1"}] 





上 述 JSON 字 符 串 摘 述 了 一 个 对 象 数组 。 该 数 
组 由 [和 ] 字 符 表 示 ， 每 个 对 象 使 用 {[ 和 } 字 符 表 示 。 
对 象 是 键 / 值 对 的 集合 ， 用 冒号 分 隔 键 和 值 ， 并 且 用 
喜 号 分 隔 键 值 对 。 这 在 广义 上 与 MemoryRepository 
类 中 用 于 定义 代码 清单 20-3 所 示 数 据 的 C# 文 字 语法 
类 似 。 





加 | 


new List<Reservation> { 


new Reservation { ClientName = "Alice", Location 
"Board Room" }, 


new Reservation { ClientName = "Bob", Location 


ecture Hall" }, 


new Reservation { ClientName = "Joe", Location 
eeting Room 1" } 





但 请 注意 ，MVC 会 将 C# 约 定 〈ClientName， 
具有 初始 大 写字 母 ) 的 属性 名 中 的 初始 大 写字 母 更 


改 为 JavaScript 约 定 〈clientName， 带 有 初始 小 写字 


即使 这 些 格式 不 完全 相同 ， 也 仍 有 很 多 相似 之 
处 ，C# 开 发 人 员 读 取 和 理解 JSON 数 据 并 不 费 
你 不 需要 了 解 大 多 数 Web 应 用 程序 的 JSON 详 细 信 
恩 ， 因 为 MVC 做 了 很 大 提升 ， 可 以 从 www.json.org 
了 解 更 多 有 关 JSON 的 信息 。 





Reservation 控 制 邦 提供 两 种 GET 操 作 。 当 把 
GET 请 求 发 送 到 /apireservation 时 ， 会 返回 包含 所 有 
对 象 的 啊 应 。 为 了 检索 单个 对 象 ， 可 将 这 个 对 象 的 
ReservationId 值 指定 为 URL 中 的 最 后 一 个 片段 ， 如 
下 所 示 : 


Invoke-RestMethod http://localhost: 7000/api/reservation 
/1 -Method GET 


以 上 命令 请 求 ReservationId 值 为 1 的 Reservation 
对 象 ， 并 产生 以 下 结果 : 


reservationId clientName location 





2. 测试 POST 操作 


API 控 制 占 提供 的 所 有 操作 都 可 以 使 用 
PowerShell 进 行 测试 ， 尽 管 命令 的 格式 可 能 有 点 怪 
寞 。 以 下 命令 同 API 控 制 占 发送 POST 请 求 ， 以 在 存 
储 库 中 创建 一 个 新 的 Reservation 对 象 ， 并 在 啊 应 中 
接收 发 回 的 数据 : 








Invoke-RestMethod http://localhost: 7000/api/reservation 
-Method POST -Body 


(@{clientName="Anne"; location="Meeting Room 4"} | Conv 
ertTo-Json) -ContentType 
“application/json" 








以 上 命令 使 用 -Body 参 数 来 指定 请 求 的 主体 ， 
请 求 的 主体 被 编 始 为 JSON。-ContentType 参 数 用 于 


设置 请 求 的 Content-Type 标 头 。 以 上 命令 将 产生 以 
下 结果 : 


reservationId clientName location 





POST 操作 使 用 clientName 和 1location 的 值 创 建 
了 一 个 Reservation 对 象 ， 并 将 这 个 新 对 象 的 JSON 表 
示 返 回 给 客户 端 ， 其 中 包括 已 分 配给 新 对 象 的 
ReservationId 值 。 这 可 能 看 起 来 像 客 户 端 只 是 接收 
到 请 求 中 发 送 给 服务 器 的 数据 值 ， 但 这 种 方法 可 以 
确保 客户 姗 正在 使 用 与 服务 器 正在 使 用 的 相同 的 数 
据 ， 并 且 可 以 满足 服务 器 对 从 客户 端 接收 的 数据 执 
行 任何 格式 化 或 翻译 操作 的 需求 。 要 查看 POST 请 
求 的 效果 ， 请 将 男 一 个 GET 请 求 发 送 到 API 
/api/reservation， 如 下 所 示 : 


Invoke-RestMethod http://localhost: 7000/api/reservation 
-Method GET 




















客户 端 返回 的 数据 反映 了 新 的 Reservation 对 象 


Board Room 


Lecture Hall 
Meeting Room 1 
Meeting Room 4 





3. 测试 PUT 操作 








PUT 操作 用 于 更 改 模 型 中 的 现 有 对 象 。 对 象 的 
ReservationId 值 被 指定 为 请 求 URL 的 一 部 分 ， 并 且 
clientName 和 jlocation 的 值 在 请 求 的 主体 中 提供 。 以 
下 PowerShell 命 令 将 发 送 一 个 PUT 请 求 来 修改 一 个 
Reservation 对 象 : 





Invoke-RestMethod http://localhost: 7000/api/reservation 
-Method PUT -Body 


(@{reservationId="1"; clientName="Bob"; location="Media 
Room"} | ConvertTo-Json) 
-ContentType "“application/json" 





上 述 PUT 请 求 会 更 改 ReservationId 值 为 1 的 
ee ， 并 为 location 属 性 指定 新 值 。 如 果 
运行 上 述 命令 ， 你 将 看 到 以 下 啊 应 ， 这 表示 更 改 已 











为 了 得 看 PUT 请 求 的 效果 ， 需 要 问 API 
/api/reservation 发送 另 一 个 GET 请 求 ， 如 下 上 所 示 : 


Invoke-RestMethod http://localhost: 7000/api/reservation 
-Method GET 


端 返 回 的 数据 反映 了 新 的 Reservation 对 象 


Board Room 


Media Room 
Meeting Room 1 
Meeting Room 4 





4. 测试 PATCH 操作 





PATCH 操作 用 于 修改 模型 中 的 现 有 对 象 。 许 

多 应 用 程序 使 用 PUT 请 求 并 完全 色 略 PATCH， 如 末 
客户 端 可 以 访问 模型 中 对 象 定义 的 所 有 属性 ， 那 么 
这 将 是 一 种 合理 的 方法 。 但 是 在 复杂 的 应 用 程序 
中 ， 出 于 安全 原因 ， 客 户 问 可 能 会 收 到 一 组 特定 的 
属性 值 ， 这 会 阻止 它们 作为 PUT 请 求 的 一 部 分 发 送 
完整 的 对 象 。 PATCH 请 求 更 具 选 择 性 ， 人 允许 客户 站 
为 对 象 指定 一 组 精细 更 改 。 








ASP.NET Core MVC 文 持 使 用 JSON Patch 标 
准 ， 从 而 允许 以 统一 的 方式 指定 更 改 。 这 里 不 打算 
详细 介绍 JSON Patch 标 准 ， 可 以 从 IETF 网 站 僵 看 。 
对 于 示例 应 用 程序 ， 客 户 端 将 发 送 HTTP PATCH 请 
求 中 的 数据 ， 如 下 所 示 : 








"op": "replace", "path": "clientName", "value": "Bob 


{ "op": "replace", "path": "location", "value": "Lectu 
re Hall"} 
] 





JSON Patch 文 档 将 被 表示 为 一 系列 操作 。 每 个 
操作 都 有 op 属性 ， 用 于 指定 操作 的 闫 型 。 万 外 ， 
个 操作 还 有 path 属 性 ， 用 于 指定 操作 的 应 用 位 置 。 














对 于 示例 应 用 程序 (事实 上 ， 对 于 大 多 数 应 用 
程序 ) ， 仅 需要 蔡 换 操作 ， 蔡 换 操 作用 于 更 改 属 性 
的 值 。 为 clientName 和 ]location 属 性 设置 新 值 ， 而 要 
修改 的 对 象 由 请 求 URL 标 识 。ASP.NET Core MVC 
将 自动 处 理 JSON 数 据 并 将 其 作为 
JsonPatchDocument<T> 对 象 呈现 给 操作 方法 ， 其 中 
TIT 是 要 修改 的 模型 对 象 的 类 型 。 然 后 ， 可 以 使 用 
JsonPatchDocument<T> 对 象 的 ApplyTo 方 法 从 存储 
库 中 修改 对 象 。 以 下 是 发 送 PATCH 请 求 的 


PowerShell 命 令 : 


Invoke-RestMethod http://localhost: 7000/api/reservation 





/2 -Method PATCH -Body (@ 

{ op="replace"; path="clientName"; value="Bob"},@{ op=" 
replace"; path="location" ; 

value="Lecture Hall"} | ConvertTo-Json) -ContentType "a 
pplication/json" 





上 述 请 求 要 求 服 务 右 修改 ReservationId 为 2 的 
Reservation 对 象 的 cientrName 和 和 location 属 性 。 要 查 
看 PUT 请 求 的 效果 ， 请 向 API /api/ reservation ix 
GET 请 求 ， 如 下 所 示 : 


Invoke-RestMethod http://localhost: 7000/api/reservation 
-Method GET 


客户 端 返 回 的 数据 反映 了 新 的 Reservation 对 象 


© Alice Board Room 


1 Bob Media Room 
2 Bob Lecture Hall 
3 Anne Meeting Room 4 





5. 测试 DELETE 操 作 


发 送 一 个 DELETE 请 求 ， 用 于 从 存储 库 中 删除 
一 个 Reservation 对 象 ， 如 下 所 示 : 


Invoke-RestMethod http://localhost: 7000/api/reservation 
/2 -Method DELETE 


Reservation? fil] 45 P Be 4CDELETE ta ok HI BRE 
不 会 返回 结果 ， 因 此 在 命令 完成 后 不 会 显示 任何 数 
据 。 要 伍 看 删除 效果 ， 请 使 用 以 下 命令 请 求 存 储 库 
中 的 内 容 : 


Invoke-RestMethod http://localhost: 7000/api/reservation 
-Method GET 


ReservationId 为 2 的 Reservation 对 象 已 从 存储 库 
中 删除 。 











reservationId clientName location 


© Alice Board Room 
1 Bob Media Room 
3 Anne Meeting Room 4 





20.3.3 ”在 浏览 器 中 使 用 API 控 制 占 





通过 定义 API 控 制 右 虽然 解决 了 应 用 程序 的 开 
放 性 问题 ， 但 是 没有 解决 速度 或 效率 问题 。 为 此 ， 
这 里 需要 更 新 应 用 程序 的 HIML 部 分 ， 以 便 靠 
JavaScript% H A PIJE H AS/A h HTTP SK LAIT ži 
操作 。 








在 浏览 器 中 ， 异 步 HTTP 请 求 通常 称 为 Ajax 请 
求 ， 其 中 Ajax 是 Asynchronous JavaScript and XML 
的 缩写 。XML 数 据 格 式 近年 来 已 不 那么 受 欢 迎 ， 但 
Ajax 仍然 用 于 引用 异步 HTTP 请 求 ， 即 使 它们 返回 
JSON 数 据 。 更 广泛 地 说 ， 本 节 摘 述 的 撤 术 是 单 页 
应 用 程序 的 基础 ， 其 中 HTML 单 页 应 用 程序 中 的 
JavaScript 用 于 为 应 用 程序 的 多 个 部 分 提取 数据 ， 以 
生成 动态 显示 的 内 容 。 

















N 
注 意 
客户 并 开发 是 本 书 范 围 内 的 讨论 主题 。 这 里 只 


创建 了 基本 的 异步 HTTP 请 求 ， 而 不 进行 详细 解 


FE 





要 想 了 解 更 多 的 信息 ， 请 参阅 由 Apress 出 版 的 
Pro ASP.NET Core MVC Client Development 一 书 ， 

其 中 详细 介绍 了 如 何 使 用 JavaScript 和 jQuery 来 创建 
从 API 控 制 右 提供 服务 的 单 页 应 用 程序 。 


A ape Fe SAA ei et A jax ta ok JavaScript 
API, (BAHETRA APES, 不同 的 浏览 占 在 实现 
一 些 可 选 功能 的 方式 上 有 一 些 差 异 。 创 建 Ajax 请 求 
的 最 简单 方法 是 使 用 jQuery 库 ，jQuery 是 客户 端 开 
发 中 非常 有 用 的 工具 。 人 代码 清单 20-11 将 jQuery 包 添 


加 到 了 bower.json 文 件 中 。 


代码 清单 20-11 在 ApiControllers 文 件 夹 下 的 bower.json 文 件 中 
添加 jQuery 包 


{ 
"name": "asp.net", 
"private": true, 
"dependencies": { 


"bootstrap": "4.0.0-alpha.6", 
"jquery": "3.2.1" 
} 





} 


实际 上 ， 由 于 某 些 Bootstrap 功 能 取决 于 
jQuery，Bower 将 会 在 wwwroot/ib 文 件 夹 中 安装 
jQuery 包 。 为 了 使 用 jQuery 提供 的 功能 ， 这 里 创建 
wwwroot/js 文 件 夹 ， 并 添加 一 个 名 为 cient.js 的 
JavaScript 文 件 ， 内 容 如 代码 清单 20-12 所 示 。 





代码 清单 20-12 ”wwwrooUjs 文 件 夹 下 的 client.js 文 件 的 内 容 





$(document).ready(function () { 


$("form").submit(function (e) { 


e.preventDefault(); 
$.ajax({ 
url: "api/reservation", 
contentType: "“application/json", 
method: "POST", 
data: JSON.stringify({ 
clientName: this.elements["ClientName" ] 


. Value, 
location: this.elements[ "Location" ].val 
ue 
J)o 
success: function(data) { 
addTableRow(data); 
} 
}) 
})3 
})3 


var addTableRow = function (reservation) { 
$("table tbody").append("<tr><td>" + reservation.re 
servationiId + "</td><td>" 
+ reservation.clientName + "</td><td>" 
+ reservation.location + "</td></tr>"); 





当 用 户 在 浏览 器 中 提交 表单 ， 将 表单 数据 编码 
为 JSJON， 并 使 用 HTTP POST 请 求 将 它们 发 送 到 服 
务 器 时 ，client.js 文 件 中 的 JavaScript 文 件 将 会 啊 
应 。 服 务 器 返回 的 JSON 数 据 将 自动 由 jQuery 解析 ， 
然后 用 于 向 HIML 表 格 中 添加 一 行 。 代 码 清 单 20-13 








更 新 了 布局 以 包含 jQuery 库 和 client.js 文 件 。 
代码 清单 20-13 ”在 _Layout.cshtml 文 件 中 添加 JavaScript 引 用 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 


<title>RESTful Controllers</title> 
<link asp-href-include="1lib/bootstrap/dist/css/*.mi 


n.css" rel="stylesheet" /> 
<script src="lib/jquery/dist/jquery.js"></script> 
<script src="js/client.js"></script> 

</head> 

<body class="m-1 p-1"> 
@RenderBody() 

</body> 

</html> 





第 一 个 script 元 素 告 诉 浏 览 器 加 载 jQuery 库 ， 
本 个 script 元 素 指 定 包 含 目 定义 代码 的 文件 。 on 
行 应 用 程序 ， 你 会 发 现 这 和 使 用 HTML 表 单 在 应 用 
程序 的 存储 库 We 区 列 。 但 
如 果 检 查 浏 览 器 发 送 的 HTTP 请 求 ， 你 会 看 到 
需要 的 数据 少 于 同步 版 本 的 应 用 程序 。 在 这 里 的 测 








试 中 ， 异 步 请 求 需要 480 字 节 的 数据 ， 大 约 是 同步 
请 求 所 需 的 40%。 数 据 的 大 小 倾向 于 比 用 于 显示 数 
据 的 HTML 文档 小 得 多 ， 在 这 样 的 实际 应 用 中 ， 疏 
进 更 为 显著 。 





20.4 内容 格式 





当 操 作 方 法 返回 C# 对 象 作 为 结果 时 ，MVC 必 
须 弄 清楚 应 该 使 用 哪 种 数据 格式 对 对 象 进行 编码 并 
发 送 给 客户 端 。 本 市 将 解释 什么 是 默认 进程 ， 以 及 
默认 进程 如 何 受 到 客户 病 发 送 的 请 求 和 应 用 程序 的 
配置 的 影响 。 为 了 帮助 理解 工作 原理 ， 这 里 将 一 个 
名 为 ContentController.cs 的 类 文件 添加 到 Controllers 
文件 夹 中 ， 并 用 来 定义 代码 清单 20-14 所 示 的 API 控 
HIA o 











代码 清单 20-14 Controllers 4-3 F KJContentController.cs ¢ 
件 的 内 容 


using Microsoft.AspNetCore.Mvc; 
using ApiControllers.Models; 


namespace ApiControllers.Controllers { 


[Route("api/[ controller ]") ] 
public class ContentController : Controller { 


[HttpGet ("string") ] 
public string GetString() => "This is a string 


response" ; 


[HttpGet ("object") ] 
public Reservation GetObject() => new Reservati 
on { 
Reservationld = 100, 
ClientName = "Joe", 
Location = "Board Room" 


le 








这 里 指定 静态 的 片段 变量 作为 HttpGet 特 性 的 参 
BN, AP Pena FAP RTE, Eee ETT A A 
通过 请 求 URL /api/controller/string 
#l/api/controller/object3# V7 [4] o Content fil #8 
松散 地 芝 循 REST 模 式 ， 但 可 以 使 你 能 够 轻松 了 解 
内 容 协 商 的 工作 原理 。 


MVC 选 择 的 内 容 格式 取决 于 4 个 因 系 一 一 客户 
闹 接 收 的 格式 ，MVC 可 以 生成 的 格式 ， 操 作 指 定 的 
内 容 集 略 以 及 操作 方法 返回 的 类 型 。 了 解 清 楚 这 一 
切 如 何 融 合 在 一 起 是 很 复杂 的 ， 但 好 消 因 是， 默认 
束 略 对 大 多 数 应 用 程序 适用 ， 你 只 需要 了 解 当 圾 要 
进行 更 改 或 未 获得 更 改 时 大 后 及 生 的 情况 ， 即 可 得 
到 期 望 的 格式 。 














20.4.1 默认 内 容 策 略 


首先 采用 标准 应 用 程序 配置 ， 当 客户 疾 和 操作 
方法 都 不 对 可 以 使 用 的 数据 格式 应 用 任何 限制 时 ， 
返回 的 结果 是 简单 和 可 预测 的 。 








。 如 本 操作 方法 返回 一 个 字符 串 ， 那 么 不 对 这 个 
字符 串 做 修改 并 发 送 给 客户 问 ， 将 啊 应 的 
Content-Type A ix E text/plain. 

。 对 于 所 有 其 他 数据 类 型 ， 包 括 其 他 简单 类 型 

(如 int) ， 数 据 格式 为 JSJON， 并 且 将 响应 的 


Content-Type 标 头 设 置 为 application/json。 





字符 串 得 到 特殊 处 理 的 原因 是 它们 在 编码 为 
JSON 时 会 导致 问题 。 当 编码 其 他 简单 类 型 〈 例 如 
C# 中 的 int 类 型 ， 值 为 2) 时 ， 结 果 是 引用 的 字符 
串 ， 比 如 "2"。 当 编码 字符 串 时 ， 会 得 到 两 组 引 
号 ， 所 以 "Hello" 变 成 "Hello""。 并 不 是 所 有 客户 端 
都 能 应 对 这 种 双重 编码 ， 所 以 使 用 textplain 格 式 更 
可 徘 ， 可 以 全 面 避 免 这 个 问题 。 这 基本 不 是 问题 ， 
因为 极 少 有 应 用 程序 直接 发 送 字 符 串 值 ， 以 JSON 
格式 发 送 对 象 更 常见 。 可 以 通过 使 用 PowerShell 查 
看 这 两 个 结果 。 以 下 命令 将 调用 GetString 方 法 并 返 
回 一 个 字符 串 : 


























Invoke-WebRequest http://localhost: 7000/api/content/str 
ing | select 


@{n='Content-Type';e={ $ .Headers."Content-Type" }}, Co 





LI EMEA [a] URL /api/content/string Rik GET 


请 求 ， 并 处 理 啊 应 以 显示 Content-Type 标 头 和 啊 应 
的 内 容 。 


o 


fe ZR 

如 果 尚 未 执行 Internet Explorer 的 初始 设置 ， 那 
么 在 使 用 Invoke-WebRequest cmdlet 时 可 能 会 收 到 错 
误 提 示 。 这 极 可 能 友 生 在 Edge 已 经 蔡 换 的 Windows 
10 计 算 机 上 。 可 以 通过 运行 下 并 选择 所 需 的 初始 配 
置 来 修复 此 问题 。 


以 上 命令 产生 的 输出 结果 如 下 : 


Content-Type Content 


text/plain; charset=utf-8 This is a string response 





同样 的 命令 也 可 以 通过 改变 请 求 的 URL 来 显示 
JSON 格 式 ， 如 下 所 示 : 


Invoke-WebRequest http://localhost: 7000/api/content/obj 
ect | select 

@{n='Content-Type';e={ $ .Headers."Content-Type" }}, Co 
ntent 





以 上 命令 产生 的 输出 格式 清晰 ， 表 明 啊 应 已 编 
但 为 JSON: 


Content-Type Content 


application/json; charset=utf-8 {"reservationId":100, 


"clientName":"Joe", 
"location": "Board Room 





20.4.2 WARDE 





大 多 数 客户 问 将 在 请 求 中 包含 Accept 标 头 ， 用 
于 指定 它们 希望 在 啊 应 中 接收 的 数据 格式 ， 以 一 组 





MIME 类 型 表示 。 以 下 是 Google Chrome 在 请 求 中 发 
送 的 Accept 标 头 : 


Accept: text/html, application/xhtml+xml, application/xml 





3q=0.9, image/webp, */*;q=0.8 


以 上 Accept 标 头 表 示 Google Chrome F] 以 处 理 
HTML、XHTML 格 式 〈XHTML 是 XML 兼容 的 
HTML 格 式 ) 、XML 和 WEBP 图 像 格式 。 标 头 中 的 
qd 值 指定 了 有 天 偏好 ， 默 认 值 为 1.0。 为 
application/xml 指 定 0.9 的 q 值 会 告诉 服务 器 Google 
Chrome 可 以 接收 XML 数据 ， 但 Google Chrome 通 党 
会 处 理 HTML 或 XHTML 数 据 。 最 后 一 项 /会 告诉 服 
3 Google Chrome 可 以 接收 任何 数据 格式 ， 但 q 值 
表明 这 是 所 有 指定 类 型 的 最 低 优 和 完 级 。 





(1) Google Chrome 通 常会 接收 
HTMIL/XHTML 数 据 或 WEBP 图 像 。 


(2) 如 果 这 些 格式 不 可 用 ， 下 一 种 优选 的 格 
式 是 XML 。 


(3) 如 果 以 上 格式 都 不 可 用 ，Google Chrome 
将 接收 任何 格式 的 数据 。 


由 此 假设 可 以 通过 设置 Accept 标 头 来 更 改 请 求 
从 MVC 应 用 程序 接收 数据 的 格式 ， 但 不 能 以 这 种 方 
式 工 作 ， 或 者 更 确切 地 说 ， 现 在 还 不 能 这 样 工作 ， 
因为 需要 做 一 些 惟 备 工 作 。 首 移 需 要 一 个 
PowerShell 命 令 ， 使 用 Accept 标 头 辐 GetObject 方 法 
发 送 GET 请 求 ，Accept 标 头 指定 客户 姗 将 仅 接 收 
XML 数据 。 





Invoke-WebRequest http://localhost: 7000/api/content/obj 
ect -Headers @{Accept="application/ 


xml"} | select @{n='Content-Type';e={ $ .Headers."Conte 
nt-Type" }}, Content 





以 下 是 请 求 返回 的 结果 ， 服 务 占 返回 了 


applicatiomjson 啊 心 : 


Content-Type Content 


application/json; charset=utf-8 {"reservationId":100, 


"clientName":"Joe", 
"location": "Board Room 











包括 Accept 标 头 的 请 求 对 返回 数据 的 格式 没有 
影响 ， 服 务 器 已 经 回 客 户 端 发 送 了 未 指定 格式 的 数 
据 。 因 为 在 默认 情况 下 MVC 仅 支持 JSON， 所 以 没 
有 其 他 可 以 使 用 的 格式 。MVC 发 送 JSON 数 据 是 希 
望 客户 端 可 以 处 理 数据 而 不 是 返回 错误 信息 ， 即 使 
JSON 格 式 不 是 请 求 的 Accept 标 头 指 定 的 格式 之 一 。 











配置 JSON Serializer 


ASP.NET Core MVC 使 用 流行 的 第 三 方 JSON 包 
Json.Net 将 对 象 序列 化 为 JSJON。 默 认 配 置 适用 于 大 


多 数 项 目 ， 但 如 末 需 要 以 特定 方式 创建 JSJON， 则 
可 以 对 它们 进行 更 改 。 可 以 在 Startup 类 中 使 用 
AddMvc().AddJsonOptions 扩 展 方法 ， 以 提供 对 
MvcJsonOptions 对 象 的 访问 ， 进 而 配置 Json.Net 包 。 
有 关 可 用 配置 选项 的 详细 信息 ， 请 参见 newtonsoft 
网 站 。 


启用 XML 格式 


为 了 在 工作 中 看 到 内 容 协商 ， 必 须 给 MVC 一 
些 用 于 对 啊 应 数据 进行 编码 的 格式 选择 。 昌 然 
JSON 已 经 成 为 Web 应 用 程序 的 默认 格式 ， 但 MVC 
也 可 以 文 持 XML 作为 编码 数据 ， 如 代码 清单 20-15 
所 示 。 


人 
提示 


从 
Microsoft.AspNetCore.Mvc.Formatters.OutputFormatte 
类 可 以 派生 和 创建 目 己 的 内 容 格式 ， 但 很 少 有 人 这 
么 做 ， 因 为 创建 目 定义 数据 格式 不 是 在 应 用 程序 中 
展示 数据 的 有 效 方式 ， 而 且 最 遇见 的 格式 JSON 和 
XML 已 经 实现 了 。 


代码 清单 20-15 “在 ApiControllers 文 件 夹 下 的 Startup.cs 文 件 中 
启用 XML 格式 





using System; 

using System.Collections.Generic; 
using System.Ling; 

using System. Threading.Tasks; 

using Microsoft.AspNetCore. Builder; 
using Microsoft.AspNetCore.Hosting; 
using Microsoft.AspNetCore.Http; 


using Microsoft.Extensions.DependencyInjection; 
using ApiControllers.Models; 


namespace ApiControllers { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<IRepository, MemoryRe 
pository>(); 
services.AddMvc().AddXm1DataContractSeriali 
zerFormatters(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 





当 MVC 只 有 JSON 格 式 可 用 时 ， 别 无 选择 ， 只 
能 将 响应 编码 为 JSJON。 现 在 有 了 另 一 选择 ， 可 以 
看 到 内 容 协 商 过 程 更 加 完善 。 








人 
提示 


这 里 使 用 了 代码 清单 20-15 中 的 
AddXmlDataContractSerializerFormatter 扩 展 方 法 ， 
但 是 你 也 可 以 使 用 AddXmlSerializerFormatters 扩 展 
方法 ， 以 提供 对 旧 的 序列 化 美的 访问 。 如 采 需 要 为 
较 早 版 本 的 .NET 客 户 端 生成 XML 内 容 ， 这 可 能 会 
很 有 帮助 。 


以 下 是 再 次 请 求 XML 数据 的 PowerShell 命 令 


Invoke-WebRequest http://localhost: 7000/api/content/obj 
ect -Headers @{Accept="application/ 


xml"} | select @{n='Content-Type';e={ $ .Headers."Conte 
nt-Type" }}, Content 





运行 上 述 命令 ， 你 将 看 到 服务 器 返回 XML 数据 


而 不 是 JSON， 如 下 所 示 (为 了 简洁 起 见 ， 这 里 省 
略 了 XML 命名 空间 特性 ) : 


Content-Type Content 


application/xml; charset=utf-8 <Reservation> 

<ClientName>Joe</Cli 
entName> 

<Location>Board Room 
</Location> 

<ReservationId>100</ 
ReservationId> 

</Reservation> 





20.4.3 ”指定 action 数 据 格 式 


你 可 以 履 盖 内 容 协商 系统 ， 并 通过 使 用 
Produces 特 性 直接 在 操作 方法 上 指定 数据 格式 ， 如 
代码 清单 20-16 所 示 。 





代码 清单 20-16 ”在 Controllers 文 件 夹 下 的 ContentController.cs 
文件 中 指定 数据 格式 








using Microsoft.AspNetCore.Mvc; 
using ApiControllers.Models; 


namespace ApiControllers.Controllers { 


[Route("api/[ controller ]") ] 
public class ContentController : Controller { 


[HttpGet ("string") ] 
public string GetString() => "This is a string 
response"; 


[HttpGet("object")] 
[Produces("application/json")] 


public Reservation GetObject() => new Reservati 
on { 


ReservationId = 100, 
ClientName = "Joe", 
Location = "Board Room" 





Produces 特 性 是 过 滤器 ， 可 以 更 改 ObjectResult 
对 象 的 内 容 类 型 ，MVC 使 用 这 些 对 象 来 表示 API 控 
制 春 中 的 action 结 末 。Produces 特 性 的 参数 不 仅 可 以 
指定 用 于 action 结 果 的 格式 ， 还 可 以 指定 其 他 的 类 
型 。Produces 特 性 将 强制 啊 应 使 用 的 格式 ， 你 可 以 
通过 运行 以 下 PowerShell 命 令 看 到 。 


(Invoke-WebRequest http://localhost:7000/api/content/ob 








ject -Headers 
@{Accept="application/xml"}).Headers."Content-Type" 





以 上 命令 将 显示 GET 请 求 URL 
/api/contentyobject 返 回 的 啊 应 中 的 Content-Type 标 头 
的 值 。 运 行 该 命令 后 你 会 有 发现， 请 求 的 Accept 标 头 
指定 应 使 用 XML， 返 回 的 数据 使 用 Produces 特 性 指 
定 的 JSON 格 式 。 








20.4.4 从 路 由 或 得 询 字符 串 获 取 数 据 格式 





Accept 标 头 并 不 总 是 在 编写 客户 端的 程序 员 的 
控制 之 下 ， 特 别 是 在 使 用 旧 的 浏览 器 或 工具 包 进 行 
开发 的 情况 下 。 对 于 这 种 情况 ， 人 允许 通过 用 于 定位 
操作 方法 或 请 求 URL 的 查询 字符 串 部 分 的 路 由 来 请 
求 啊 应 的 数据 格式 是 有 帮助 的 。 第 一 步 是 在 Startup 
类 中 定义 可 用 于 引用 路 由 或 僵 询 字符 串 格 式 的 速记 
值 。 黑 认 情 况 下 有 一 个 映射 ， 其 中 json 用 作 
applicatiomrjson 的 缩写 。 代 码 清单 20-17 玉 加 了 一 个 




















额外 的 XML 映射 。 


代码 清单 20-17 在 ApiControllers 文 件 夹 下 的 Startup.cs 文 件 中 
添加 格式 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using ApiControllers.Models; 

using Microsoft.Net.Http.Headers ; 


namespace ApiControllers { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<IRepository, MemoryRe 
pository>(); 
services.AddMvc() 
.AddXm1DataContractSerializerFormatters 
() 
-AddMvcOptions(opts => { 
opts. FormatterMappings.SetMediaType 
MappingForFormat("xml", 
new MediaTypeHeaderValue("appli 
cation/xml")); 


}); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 





MvcOptions.FormatterMappings 属 性 用 于 设置 和 
管理 映射 。 在 以 上 代码 中 ， 使 用 
SetMediaTypeMapping- ForFormat 方 法 创建 了 一 个 
新 的 映射 ， 以 便 简写 的 xml 代 表 application/xml 格 
式 。 下 一 步 是 将 FormatFilter 属 性 应 用 于 操作 方法 ， 
并 可 选 地 调整 操作 的 路 由 ， 使 它 包含 format 变 量 ， 
如 代码 清单 20-18 所 示 。 


代码 清单 20-18 在 Controllers 文 件 严 下 的 ContentController.cs 
文件 中 应 用 FormatFilter 特 性 


using Microsoft.AspNetCore.Mvc; 
using ApiControllers.Models; 


namespace ApiControllers.Controllers { 


[Route("api/[ controller ]") ] 
public class ContentController : Controller { 


[HttpGet ("string") ] 
public string GetString() => "This is a string 
response" ; 


[HttpGet ("object/{format?}") ] 
[FormatFilter ] 
[Produces("application/json", "application/xml" 


)] 
public Reservation GetObject() => new Reservati 
on { 
ReservationId = 100, 
ClientName = "Joe", 
Location = "Board Room" 


}; 





这 里 已 经 将 FormatFilter 特 性 应 用 于 GetObject 方 
法 ， 并 修改 了 操作 的 路 由 ， 使 之 包 仿 可 选 的 format 
字段 。 不 必 将 Produces 特 性 与 FormatFilter 特 性 一 起 
使 用 ， 但 如 果 这 样 做 ， 那 么 只 有 指定 Produces 特 性 
配置 格式 的 请 求 才 能 正常 工作 。 指 定 Produces 特 性 
尚未 配置 的 格式 的 请 求 将 收 到 404-Not Found 啊 应 。 








如 采 不 应 用 Produces 特 性 ， 那 么 请 求 可 以 使 用 MVC 
被 配置 的 任何 格 陈 。 


这 里 还 将 application/xml 格 式 添 加 到 Produces 特 
性 中 ， 以 使 操作 方法 文 持 对 JSON 和 XML 的 请 求 。 





以 下 PowerShell 命 令 将 xml 格 式 指 定 为 请 求 URL 


HIER: 


(Invoke-WebRequest http://localhost:7000/api/content/ob 


ject/xml).Headers. "Content-Type" 





运行 以 上 命令 显示 啊 应 的 内 容 类 型 ， 如 下 所 


2N: 


application/xml; charset=utf-8 


使 用 FormatFilter 特 性 查找 名 为 format 的 路 由 片 
段 变 量 ， 获 取 其 中 包含 的 速记 值 ， 并 从 应 用 程序 配 
置 中 检索 关联 的 数据 格式 ， 然 后 用 于 啊 应 。 如 果 没 








有 可 用 的 路 由 数据 ， 束 检查 碍 询 字 符 串 。 以 下 是 使 
用 和 查询 字符 串 请 求 XMEL 的 PowerShell 命令: 





(Invoke-WebRequest http://localhost:7000/api/content/ob 


ject? format=xml) .Headers. "Content-Type" 





FormatFilter## VE 4% FI AY #5 SUK i Accept% 
指定 的 任何 格式 ， 即 使 在 使 用 不 允许 Accept 标 头 设 
置 的 工具 包 和 浏览 器 的 情况 下 ， 也 可 以 将 格式 选择 
权 和 掌握 在 客户 端 开 发 人 员 手 中 。 





20.4.5 ”启用 完成 内 容 协 商 


对 于 大 多 数 应 用 程序 来 说 ， 当 没有 其 他 格式 可 
用 时 及 送 JSON 数 据 是 明智 的 ， 因 为 Web 应 用 程序 的 
客户 问 很 可 能 错误 设置 了 接收 标 涉 ， 而 不 是 不 能 处 
理 JSON。 也 束 是 说 ， 如 果 不 管 Accept 标 头 是 什么 
JSON 都 被 返回 ， 一 些 应 用 程序 将 不 得 不 处 理 那 些 
导致 问题 的 客户 疹 。 获 取 内 容 协商 需要 在 Startup 类 








中 更 改 两 个 配置 ， 如 代码 清单 20-19 所 示 。 


代码 清单 20-19 在 ApiControllers 文 件 夹 下 的 Startup.cs 文 件 中 
局 用 完成 内 容 协商 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading.Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using ApiControllers.Models; 

using Microsoft.Net.Http.Headers ; 


namespace ApiControllers { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<IRepository, MemoryRe 
pository>(); 
services.AddMvc() 
.AddxXm1DataContractSerializerFormatters 
() 
.AddMvcOptions(opts => { 
opts.FormatterMappings.SetMediaType 
MappingForFormat("xml", 
new MediaTypeHeaderValue("appli 
cation/xml")) ; 
opts.RespectBrowserAcceptHeader = t 


rue; 
opts.ReturnHttpNotAcceptable = true; 


}); 
} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 





RespectBrowserAcceptHeader 选 项 用 于 控制 是 
售 完 全 章 守 Accept 标 头 。 如 朱 设 有 合适 的 格式 可 
用 ，ReturnHttpNotAcceptable 选 项 用 于 控制 是 否 将 
406-Not Acceptable 啊 应 发 送 到 客户 端 。 





这 里 还 必须 从 操作 方法 中 删除 Produces 特 性 ， 
以 使 内 容 协 商 过 程 不 被 敌 羡 ， 如 代码 清单 20-20 所 
不 。 





代码 清单 20-20 ”在 Controllers 文 件 夹 下 的 ContentController.cs 


文件 中 删除 Produces 特 性 


using Microsoft.AspNetCore.Mvc; 
using ApiControllers.Models; 


namespace ApiControllers.Controllers { 


[Route("api/[ controller ]") ] 
public class ContentController : Controller { 


[HttpGet ("string") ] 
public string GetString() => "This is a string 
response"; 


[HttpGet("object/{format?}")] 
[FormatFilter] 
//[Produces("application/json", "“application/xm 


public Reservation GetObject() => new Reservati 


ReservationId = 100, 
ClientName = "Joe", 
Location = "Board Room" 





这 里 有 一 个 PowerShell 命 令 ， 用 于 
问 /api/content/object 发 送 GET 请 求 ， 并 使 用 Accept 标 
头 指定 应 用 程序 无 法 提供 的 内 容 类 型 : 











Invoke-WebRequest http://localhost: 7000/api/content/obj 


ect -Headers 
@{Accept="application/custom" } 





如 果 运 行 以 上 命令 ， 你 将 看 到 406 错 误 消 忆 ， 
指示 服务 器 无 法 提供 请 求 的 格式 。 


20.4.6 ”接收 不 同 的 数据 格式 


Se PF im TP Hill as AIG (例如 POST 请 
He) 时， 可 以 使 用 Consumes 特 性 指定 不 同 的 操作 方 
法 来 处 理 特定 的 数据 格式 ， 如 代码 清单 20-21 所 
不 。 





代码 清单 20-21 在 Controllers 文 件 夹 下 的 ContentController.cs 
文件 中 处 理 不 同 的 数据 格式 





using Microsoft.AspNetCore.Mvc; 
using ApiControllers.Models; 


namespace ApiControllers.Controllers { 
[Route("api/[ controller ]") ] 
public class ContentController : Controller { 


[HttpGet ("string") ] 


public string GetString() => "This is a string 
response" ; 


[HttpGet ("object/{format?}") ] 
[FormatFilter | 
//[Produces("application/json", "“application/xm 


on 
public Reservation GetObject() => new Reservati 
on { 
ReservationId = 100, 
ClientName = "Joe", 
Location = "Board Room" 
}; 
[HttpPost] 


[Consumes("application/json")] 
public Reservation ReceiveJson([FromBody] Reser 
vation reservation) { 
reservation.ClientName = "Json"; 
return reservation; 


} 


[HttpPost ] 
[Consumes("application/xml" ) ] 
public Reservation ReceiveXml([FromBody] Reserv 
ation reservation) { 
reservation.ClientName = "Xml"; 
return reservation; 





ReceiveJson 和 ReceiveXml 操 作 都 接收 POST 请 


求 ， 它 们 之 间 的 区 别 在 于 使 用 Consumes 特 性 指定 的 
数据 格式 ， 检 查 Content-Type 标 头 ， 以 确定 操作 方 
法 是 否 可 以 处 理 请 求 。 当 有 请 求 的 Content-Type 设 
置 为 application/json 时 ， 使 用 ReceiveJson 方 法 ; 4 
ContentType 设 置 为 application/xml 时 ， 使 用 
ReceiveXml 方 法 。 





20.5 ”小 结 


本 章 介绍 了 API 控 制 器 在 MVC 应 用 程序 中 的 作 
用 ， 演 示 了 如 何 创 建 和 测试 API 控 制 器 ， 还 简要 演 
示 了 如 何 使 用 jQuery 进行 异步 HITP 请 求 ， 并 解释 了 
内 容 的 格式 化 过 程 。 下 一 章 将 更 详细 地 解释 视图 和 
视图 引擎 的 工作 原理 。 


第 21 章 ”视图 


第 17 章 讲述 了 操作 方法 如 何 返 回 ViewResult 对 
象 ， 该 对 象 用 于 告诉 MVC 泻 染 视 图 并 回 客 户 端 返回 
HTML Dy. . 





在 本 书 中 ， 你 已 经 看 到 许多 示例 中 使 用 的 视 
图 ， 大 人 致 了 解 了 它们 的 作用 ， 本 章 将 对 视图 进行 更 
深入 的 介绍 。 





本 章 首 先 展 示 MVC 如 何 使 用 视图 引擎 处 理 
ViewResult 对 象 ， 包 括 演示 如 何 创建 目 定义 视图 引 
擎 ， 然 后 介绍 如 何 有 效 地 使 用 内 置 的 Razor 视 图 引 
擎 ， 包 括 使 用 分 部 视图 和 布局 部 分 ， 这 是 涉及 有 效 
进行 MVC 开 发 的 重要 内 容 。 表 21-1 介 绍 了 视图 的 背 


有 与 
AK o 





表 21-1 视图 的 背景 
































视图 是 用 于 向 用 





MVC FIFE 


























处 理 以 生成 响 























视图 允许 将 数据 的 呈现 与 处 型 


























显示 内 容 的 MVC 模 式 的 一 部 分 。 在 ASP.NET Core 
， 视 图 是 包含 HTML 元 素 和 C# 代 码 的 文件 ， 


它们 将 被 


请 求 的 逻辑 分 开 。 视 图 还 允许 在 整个 应 





用 程序 中 应 用 相同 的 演示 文稿 ， 因 为 许多 控制 器 可 以 使 用 相同 的 视图 

















大 多 数 MVC 应 
C# 内 容 。 如 第 17 章 所 述 ， 视 图 可 通过 返回 
法 的 结果 得 以 选择 


















































尔 可 能 需要 一 段 时 间 才 能 习惯 使 
























































这 有 助 于 揭示 一 些 常 用 操作 


其 他 的 蔡 
代 方 案 ? 






































视图 引擎 可 用 于 MVC， 但 是 它们 的 使 用 乱 











表 21-2 列 出 了 本 章 要 介绍 的 操作 。 


表 21-2 ”本章 要 介绍 的 操作 





























程序 使 用 Razor 视 图 引擎 ， 这 可 以 轻松 地 混合 HTML 和 和 
ViewResult 对 象 作为 操作 方 





Razor。 本 章 将 解释 Razor 如 何 工作 ， 





操作 





方法 


代码 } 
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实现 IViewEngine 和 IView | 代码 清单 21-3 一 代码 清 让 
m 21-6 

















创建 自 定义 视图 引擎 



































轻松 创建 混合 了 HTML 和 C# 代 码 | 代码 清单 21-7 一 代码 清 自 
使 用 Razor 视 图 
的 响应 21-11 






































和 21-12 一 代码 清和 



































局 的 内 容 区 域 




















和 21-19 一 代码 清 六 
































创建 可 重用 的 标记 片段 



































使 用 @ Json.Serialze 表 达 “| 代码 清单 21-23 一 代码 清和 
it 21-25 























在 视图 中 添加 JSON 内 容 

















让 21-26 一 代码 清 自 



































更 改 Razor 搜 索 视 区 创建 视图 位 置 扩 展 

















21.1 准备 示例 项 目 


在 本 章 中 ， 使 用 ASP.NET Core Web 
Application (.NET Core) 模板 创建 一 个 名 为 Views 
的 Empty 项 目 。 为 了 启用 MVC 框 架 和 其 他 对 开发 有 
用 的 中 间 件 ， 对 Startup 类 进行 代码 请 单 21-1 所 示 的 





更 改 。 


代码 清单 21-1 Startup.cs 文 件 的 内 容 


using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace Views { 
public class Startup { 
public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 





创建 Controllers 文 件 夹 ， 添 加 一 个 名 为 


HomeController.cs 的 类 文件 ， 并 用 它 定 义 控 制 器 ， 
如 代码 清单 21-2 所 示 。 


代码 清单 21-2 ”Controllers 文 件 夹 下 的 HomeController.cs 文 件 的 
内 容 


using System; 
using Microsoft.AspNetCore.Mvc; 


namespace Views.Controllers { 


public class HomeController : Controller { 


public ViewResult Index() { 
ViewBag.Message = "Hello, World"; 
ViewBag.Time = DateTime.Now. ToString("HH:mm 


return View("DebugData”" ) ; 


} 


public ViewResult List() => View(); 





21.2 ”创建 目 定 义 视图 引擎 





本 市 将 深入 剖析 如 何 创建 目 定 义 视 图 引擎 。 在 


绝 大 多 数 项 目 中 并 不 需要 执行 此 操作 ， 因 为 MVC 提 
供 了 Razor 视 图 引擎 ， 第 5 章 介 绍 了 Razor 的 用 法 ， 
Razor 将 出 现在 本 书 的 所 有 示例 中 。 











创建 目 定义 视图 引擎 的 价值 在 于 碍 看 后 全 发 生 
的 情况 ， 并 扩展 你 对 MVC 运 行 方式 的 了 解 ， 包 括 了 
解 视 图 引擎 在 将 ViewResult 转 换 为 对 客户 端的 响应 
时 有 多 少 目 由 度 。 








视图 引擎 是 实现 了 IViewEngine 接 口 的 类 ， 定 
义 在 Microsoft.AspNetCore.Mvc.ViewEngines 命 名 空 
则 中 。 以 下 是 IViewEngine 接 口 的 定义 : 





namespace Microsoft.AspNetCore.Mvc.ViewEngines { 
public interface IViewEngine { 


ViewEngineResult GetView(string executingFilePa 
th, string viewPath, 
bool isMainPage) ; 


ViewEngineResult FindView(ActionContext context 
» string viewName, 
bool isMainPage) ; 


} 


Pe 

视图 引擎 的 作用 是 将 对 视图 的 请 求 转换 为 
ViewEngineResult 对 象 。 当 MVC 需 要 视图 时 ， 将 调 
用 GetView 方 法 ， 使 视图 引 敬 根据 视图 名 称 来 提供 
AILS 











视图 引擎 所 做 的 工作 是 为 MVC 提 供 可 用 于 生 
成 啊 应 的 ViewEngineResult 对 象 。ViewEngineResult 
类 不 能 直接 实例 化 ， 而 是 提供 用 于 创建 实例 的 静态 
方法 ， 如 表 21-3 所 示 。 


表 21-3 ViewEngineResult 类 的 静态 方法 


为 MVC 提 供 请 求 的 视图 ， 该 视图 是 使 用 view 参 数 设 置 的 。 视 医 
Found(name,view) 、 
实现 了 IView 接 口 









































创建 一 个 ViewEngineResult 对 象 ， 以 告诉 MVC 找 不 到 请 求 的 视 
NotFound(name,locations) | 图 。locations 参 数 是 描述 视图 引擎 查看 视图 位 置 的 字符 串 值 的 枚 
àE 




































































在 编写 视图 引擎 时 ， 可 以 选择 表 21-3 中 描述 的 
方法 之 一 来 指示 视图 请 求 的 结果 。Found 方 法 会 创 
束 一 个 指示 请 求 成 功 的 ViewEngineResult 对 象 ， 并 
为 MVC 提 供 要 处 理 的 视图 。NotFound 方 法 会 创建 
一 个 ViewEngineResult 对 象 ， 指 示 不 成 功 的 请 求 ， 

并 问 MVC 提 供 视 图 引擎 在 全 找 视图 时 搜索 过 的 位 置 
清单 《还 将 作为 错误 消息 的 一 部 分 显示 给 开 及 人 


Wass 











视图 引擎 系统 的 万 一 个 构建 模块 是 IView 接 
口 ， 用 于 摘 述 视图 提供 的 功能 ， 而 不 考虑 创建 它们 
的 视图 引擎 。 以 下 为 IView 接 口 的 定义 : 





using Microsoft.AspNetCore.Mvc.Rendering; 
using System. Threading. Tasks; 


namespace Microsoft.AspNetCore.Mvc.ViewEngines { 
public interface IView { 
string Path { get; } 


Task RenderAsync(ViewContext context) ; 


} 


Pe 


Path} PER IAA eR, EEE A AVE 
在 磁盘 上 的 文件 。RenderAsync 方 法 由 MVC 调 用 以 
生成 对 客户 端的 啊 应 。 通 过 从 ActionContext 派 生 的 
ViewContext 类 的 实例 将 Context 数 据 提 供给 视图 。 
除 从 父 类 继承 的 Context 属 性 用 于 提供 对 请 求 的 访 
问 、 路 由 数据 、 控 制 器 等 ) 之 外 ，ViewContext 类 
还 提供 了 这 染 啊 应 中 有 用 的 属性 ， 见 表 21-4。 








7221-4 ViewContext 有 用 的 属性 
































返回 一 个 ViewDataDictionary 对 象 ， 该 对 象 包含 控制 器 提供 的 视图 交 

















返回 包含 临时 数据 的 字典 











返回 一 个 TextWriter 对 象 ， 用 于 写 入 视图 的 输出 














这 些 属性 中 最 有 用 的 是 ViewData， 它 返回 一 个 


ViewDataDictionary 对 象 。ViewDataDictionary 类 定 
义 了 一 些 有 用 的 属性 ， 可 以 访问 视图 模型 、 视 图 包 
和 视图 模型 元 数据 。 表 21-5 列 出 了 这 些 有 用 的 属 

性 。 


#£21-5 ”ViewDataDictionary 有 用 的 属性 


T seas a 
pcan | 回 一 个 ModelMetadata 对 象 ， 该 对 象 可 用 于 反映 模型 数据 的 类 型 



















































































pom h am ntvewbagin int 


#24 IviewEngine. ViewEngineResult#lllView HII 
何 结合 在 一 起 工作 的 最 简单 方法 是 创建 视图 引擎。 
这 里 将 创建 一 个 简单 的 视图 引擎 ， 返 回 一 种 视图 ， 
以 呈现 包含 有 关 请 求 的 信息 以 及 由 操作 方法 生成 的 


















































视图 数据 的 结果 。 这 种 方法 有 助 于 演示 视图 引擎 的 
运行 方式 ， 而 不 会 影响 解析 视图 模板 和 重新 创建 
Razor 提 供 的 其 他 功能 。 


21.2.1 ”创建 自 定 义 IView 


本 节 将 从 创建 ITView 接 口 的 实现 开始 。 在 示例 
项 目 中 创建 Infrastructure 文 件 夹 ， 并 添加 一 个 名 为 
DebugDataView.cs 的 类 文件 ， 如 代码 清单 21-3 所 
示 。 


代码 清单 21-3 ”Infrastructure 文 件 夹 下 的 DebugDataView.cs 文 件 
的 内 容 





using System; 

using System.Text; 

using System.Threading.Tasks; 

using Microsoft.AspNetCore.Mvc.Rendering; 
using Microsoft.AspNetCore.Mvc.ViewEngines; 


namespace Views.Infrastructure { 


public class DebugDataView : IView { 
public string Path => String.Empty; 


public async Task RenderAsync(ViewContext conte 
xt) { 
context .HttpContext.Response.ContentType = 
"text/plain"; 


StringBuilder sb = new StringBuilder() ; 


sb.AppendLine("---Routing Data---"); 
foreach (var kvp in context.RouteData.Value 


s) { 


{kvp.Value}") ; 
} 
sb.AppendLine('"---View Data---"); 
foreach (var kvp in context.ViewData) { 
sb.AppendLine($"Key: {kvp.Key}, Value: 


sb.AppendLine($"Key: {kvp.Key}, Value: 


Wwe 


{kvp.Value}") 
} 


await context.Writer.WriteAsync(sb.ToString 





HERLAER, MEH ViewContext ži] 
RenderAsync 方 法 写 入 路 由 数据 和 视图 数据 的 详细 
言 思 。 啊 应 是 简单 的 文本 ， 以 上 代码 已 经 使 用 
context 对 象 设置 啊 应 的 Content-Type 标 头 为 
text/plain。 不 这 么 做 的 话 ，ASP.NET 默 认 会 使 用 








text/html， 这 将 导致 浏览 带 将 数据 显示 为 单个 不 间 
PAT AT o 


21.2.2 ”创建 IViewEngine 实 现 


视图 引擎 的 目的 是 生成 一 个 ViewEngineResult 
对 象 ， 该 对 象 包含 一 个 IView 或 者 一 个 用 于 搜索 合 
适 视 图 的 位 置 清单 。 既 然 有 了 IView 实 现 ， 束 可 以 
创建 视图 引擎 。 在 Infrastructure 文 件 夹 中 添加 一 个 
名 为 DebugDataViewEngine.cs 的 类 文件 ， 内 容 如 代 
码 清单 21-4 所 示 。 





代码 清单 21-4 ”Infrastructure 文 件 夹 下 的 
DebugDataViewEngine.cs 文 件 的 内 容 





using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.ViewEngines; 


namespace Views.Infrastructure { 
public class DebugDataViewEngine : IViewEngine { 


public ViewEngineResult GetView(string executin 


gFilePath, string viewPath, 
bool isMainPage) { 
return ViewEngineResult.NotFound(viewPath, 
new string[] { "(Debug View Engine - Ge 
tView)" }); 
} 


public ViewEngineResult FindView(ActionContext 
context, string viewName, 
bool isMainPage) { 
if (viewName == "DebugData") { 
return ViewEngineResult.Found(viewName, 
new DebugDataView() ) ; 
} else { 
return ViewEngineResult.NotFound(viewNa 
me, 
new string[] { "(Debug View Engine 


- FindView)" }); 





这 个 视图 引擎 中 的 GetView 方 法 始终 返回 
NotFound 啊 应 。FindView 方 法 仅 文 持 单个 视图 ， 名 
为 DebugData。 当 接收 到 具有 这 一 名 称 的 视图 请 求 
时 ， 就 返回 一 个 新 的 DebugDataView 实 例 ， 如 下 所 
7N: 





if (viewName == "DebugData") { 
return ViewEngineResult.Found(viewName, new DebugDa 


taView()); 
} 








如 果 正 在 实现 一 个 更 完整 的 视图 引擎 ， 那 么 可 
以 利用 这 个 机 会 来 搜索 模板 。 但 在 这 个 示例 中 ， 只 
需要 一 个 新 的 DebugDataView 实 例 。 如 果 收 到 除 
DebugData 之 外 的 视图 请 求 ， 将 创建 NotFound 啊 
应 ， 如 下 所 示 : 


return ViewEngineResult.NotFound(viewName, 


new string[] { "(Debug View Engine - FindView)" }); 





ViewEngineResult,NotFound 方 法 假定 视图 引擎 
有 共有 得 找 视图 所 需 的 位 置 。 这 是 一 个 合理 的 假设 ， 
因为 视图 通 弟 是 作为 项 目 中 的 文件 存储 的 模板 文 
件 。 在 这 种 情况 下 ， 没 有 任何 地 方 可 以 得 找 视 图 ， 
所 以 只 返回 一 个 虚拟 位 置 ， 以 指示 调用 哪个 方法 来 











定位 视图 。 
21.2.3 ”注册 自 定义 视图 引 苟 


视图 引擎 可 通过 配置 MvcViewOptions 对 象 在 
Startup 类 中 注册 ， 如 代码 清单 21-5 所 示 。 


代码 清单 21-5 ”在 Startup.cs 文 件 中 注册 目 定 义 视 图 引擎 





uSing System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.AspNetCore.Mvc; 

using Views.Infrastructure; 


namespace Views { 
public class Startup { 
public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 
services. Configure<MvcViewOptions>(options 


options.ViewEngines.Insert(@, new Debug 
DataViewEngine() ); 


}); 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 





MvcViewOptions 类 定义 了 ViewEngines 属 性 ， 
其 值 是 一 组 IViewEngine 对 象 。Razor 可 通过 AddMvc 
方法 添加 到 ViewEngine 集 合 中 ， 这 里 使 用 目 定 义 类 
ADF T ERU AMAL S| BE. 


当 MVC 从 一 个 操作 方法 接收 到 一 个 ViewResult 
对 象 时 ， 它 会 调用 MvcViewOptions.ViewEngines 集 
合 中 包含 的 每 个 视图 引 敬 的 FindView 方 法 ， 直 到 收 
到 使 用 Found 方 法 创建 的 ViewEngineResult 对 象 。 


如 果 两 个 或 多 个 视图 引擎 能 够 为 视图 名 称 相同 
的 请 求 提供 服务 ， 那 么 将 视图 引擎 添加 到 





ViewEngines.Engines 集 合 的 顺序 非常 重要 。 要 使 你 
的 视图 优先 ， 应 将 其 插入 视图 引擎 集合 的 开头 ， 如 
代码 清单 21-5 所 示 。 


21.2.4 测试 视图 引擎 


当 应 用 程序 局 动 时 ， 浏 览 右 将 自动 导航 到 项 目 
的 根 URL， 根 URL 将 映射 到 Home 控 制 器 中 的 Index 
操作 方法 。 这 个 操作 方法 使 用 View 方 法 返回 用 于 指 
定 DebugData 视 图 的 ViewResult 对 象 。 





MVC 将 转 回 视图 引擎 的 集合 ， 并 开始 调用 它 
们 的 FindView 方 法 。 由 于 请 求 的 视图 是 自 定义 视图 
引擎 设置 为 将 要 人 处理 的 视图 ， 因 此 为 MVC 提 供 一 个 
人 视图， 该 视图 将 产生 图 21-1 所 示 的 结 

















[} locathost:61386 
CS | © locathost:61386 x ies 


~--Routing Data--- 


| Key: Message, Value: Hello, World 
| Key: Time, Value: 14:33:56 


图 21-1 使 用 目 定 义 视图 引擎 


要 簿 看 当 没 有 视图 引擎 可 以 提供 视图 时 会 发 生 
什么 ， 可 请 求 URL 一 一 /Home/List， 这 将 创建 一 个 
ViewResult 对 象 ， 指 同一 个 名 为 List 的 视图 ，List 视 
图 既 不 是 Razor 提 供 的 ， 也 不 是 自 定义 视图 引擎 提 





供 的 。 你 将 看 到 图 21-2 所 示 的 错误 。 





[D Internal Server Error 
E CŒ | © localhost61386/Home/List wv) : 


An unhandled exception occurred while processing the request 








View) 


ug View Engine - Finc 
à D s ee a 


图 21-2 请求 无 法 提供 的 视图 


可 以 看 到 ， 自 定义 视图 引擎 报告 了 寻找 List 视 
图 的 位 置 列表 ， 同 时 还 报告 了 Razor 已 检查 的 位 


置 。 


如 果 想 确保 只 有 你 的 视图 引擎 被 使 用 ， 那 承 必 
须 对 视图 引擎 的 集合 调用 Clear 方 法 来 删除 Razor， 
如 代码 清单 21-6 所 示 。 





代码 清单 21-6 ”在 Views 项 目的 Startup.cs 文 件 中 删除 其 他 视图 


引擎 





using 
using 
using 
using 
using 
using 
using 
using 
using 
using 


System; 

System.Collections.Generic; 

System. Ling; 

System. Threading.Tasks; 
Microsoft.AspNetCore. Builder; 
Microsoft.AspNetCore.Hosting; 
Microsoft.AspNetCore.Http; 
Microsoft.Extensions.DependencyInjection; 
Microsoft.AspNetCore.Mvc; 

Views. Infrastructure; 


namespace Views { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 


n services) { 


services.AddMvc(); 


services.Configure<MvcViewOptions>(options 
=> { 
options.ViewEngines.Clear(); 
options.ViewEngines.Insert(@, new Debug 
DataViewEngine()); 


}); 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 








如 果 启 动 应 用 程序 并 再 次 导航 到 /Home/List， 
将 只 会 使 用 目 定 义 视图 引擎 ， 如 图 21-3 所 示 。 














图 21-3 ”在 示例 应 用 程序 中 仪 使 用 自 定 义 视图 引擎 


21.3 ”使 用 Razor 引 = 





可 以 通过 仅 实现 两 个 接口 来 创建 自 定义 视图 引 
掌 ，MVC 让 添加 或 替换 核心 功能 变 得 十 分 轻松 。 


视图 引擎 的 复杂 性 来 目 视 图 模板 系统 ， 包 括 代 
人 码 上 请 段 、 文 持 布局 和 性 能 优化 。 这 里 在 简单 的 目 定 
义 视图 引 敬 中 没有 做 以 上 这 些 事情 ， 也 没有 太 多 和 需 
要 ， 因 为 内 置 的 Razor 引 擎 握 供 了 所 有 这 些 功能 。 
实际 上 ， 几 乎 所 有 MVC 应 用 程序 所 需 的 功能 都 可 以 
在 Razor 中 使 用 。 只 有 极 少 量 的 项 目 需要 目 定 义 视 
图 引擎 。 

















第 5 章 给 出 了 关于 Razor 语 法 的 介绍 ， 本 节 将 展 
示 如 何 使 用 其 他 功能 来 创建 和 演 染 Razor 视 图 ， 还 
将 讲述 如 何 目 定义 Razor 引 擎 。 


21.3.1 准备 示例 项 目 


为 了 使 用 Razor， 和 需要 对 示例 应 用 做 一 些 修 
改 。 首 先 ， 更 改 Home 控 制 右 的 mdex 操 作 方 法 ， 以 
便 选 择 默认 视图 并 提供 一 些 模型 数据 ， 如 代码 清单 
21-7 所 示 。 


代码 清单 21-7 修改 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 的 Index 操 作 方 法 


using System; 
using Microsoft.AspNetCore.Mvc; 


namespace Views.Controllers { 


public class HomeController : Controller { 


public ViewResult Index() => 
View(new string[] { "Apple", "Orange", "Pea 


public ViewResult List() => View(); 





AS WIndexfevevrizte eA, eile 
Views/Home 文 件 夹 ， 并 添加 一 个 名 为 index.cshtml 


的 视图 文件 ， 内 容 如 代码 清单 21-8 所 示 。 


代码 清单 21-8 ”Views/Home 文 件 夹 下 的 index.cshtml 文 件 的 内 


mL 


4S 


@model string[ ] 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Razor</title> 
<link asp-href-include="1lib/bootstrap/dist/css/*.mi 
n.css" rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
This is a list of fruit names: 
@foreach (string name in Model) { 
<span><b>@name</b></span> 
} 
</body> 
</html> 





Index # Al (Ki F Bootstrap CSS 库 ， 要 将 
Bootstrap 添 加 到 示例 项 目 中 ， 可 使 用 Bower 
Configuration File 模 板 在 项 目的 根 文件 夹 中 创建 


bower.json 文 件 ， 内 容 如 代码 清单 21-9 所 示 。 
代码 清单 21-9 bower.json 文 件 的 内 容 


{ 
"name": "asp.net", 
"private": true, 
"dependencies": { 
"bootstrap": "4.0.0-alpha.6" 


} 





} 


fE Views CFF PY 44 A 
_ViewImports.cshtml 的 视图 文件 ， 以 启用 内 置 的 标 
签 助手 ， 如 代码 清单 21-10 所 示 。 


代码 清单 21-10 Views 文件 夹 下 的 _ViewImports.cshtml 文 件 的 
内 容 


最 后 的 准备 步骤 是 重新 局 动 Startup 类 中 的 视图 
引 敬 以 删除 日 定义 引擎 ， 并 删除 用 来 禁用 Razor 的 
Clear 方 法 调用 ， 如 代码 清单 21-11 所 示 。 








代码 清单 21-11 重启 Startup.cs 文 件 中 的 视图 引擎 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.AspNetCore.Mvc; 

using Views.Infrastructure; 


namespace Views { 
public class Startup { 
public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 
//services.Configure<MvcViewOptions>(option 


s => { 

// options .ViewEngines.Clear(); 

// options.ViewEngines.Insert(@, new Deb 
ugDataViewEngine()) ; 

/1})3 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 


如 果 运 行 示 例 项 目 ， 你 将 看 到 图 21-4 所 示 的 结 
R, 





D Razor 
€ GC |© localhost 





This is a list of fruit names: Apple Orange Pear 











/一 — 


图 21-4 运行 示例 项 目 


21.3.2 ”Razor 视 多 


了 解 Razor 的 工作 原理 可 以 帮助 将 大 量 功能 引 
入 上 下 文中 ， 并 揭 开 CSHTML 文件 处 理 方 式 的 谜 


那么 ，Razor 如 何 将 HTML 元 素 和 C# 语 句 相 结 
合 ， 并 产生 HTTP 啊 应 的 内 容 ? 丛 案 简单 明了 ， 它 
们 建立 在 MVC 功 能 的 基础 之 上 ， 你 已 经 在 前 面 的 章 
节 中 了 解 了 这 些 功 能 。Razor 将 CSHTML 文 件 转换 











为 C# 类 并 编译 ， 然 后 在 每 次 需要 视图 生成 结果 时 便 
建新 的 实例 。 下 面 是 Razor 为 Index.cshtml 创 建 的 C# 





using System.Threading.Tasks; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.Razor; 

using Microsoft.AspNetCore.Mvc.Razor.Internal; 
using Microsoft.AspNetCore.Mvc.Rendering; 


namespace Asp { 


public class ASPV_Views_Home_Index_cshtml : RazorPa 
ge<string|[ ]> { 


public IUrlHelper Url { get; private set; } 


public IViewComponentHelper Component { get; pr 
ivate set; } 


public IJsonHelper Json { get; private set; } 


public IHtmlHelper<string[ ]> Html { get; privat 
e set; } 


public override async Task ExecuteAsync() { 
Layout = null; 


WriteLiteral(@"<!DOCTYPE html><html><head> 
<meta name=""viewport"" content=""width 
=device-width"" /> 
<title>Razor</title> 


<link asp-href-include=""1lib/bootstrap/ 
dist/css/*.min.css"" 
rel=""stylesheet"" /> 
</head><body class=""m-1 p-1"">This is 
a list of fruit names:"); 
foreach (string name in Model) { 
WriteLiteral("<span><b>") ; 
Write(name) ; 
WriteLiteral("</b></span>"); 


WriteLiteral("</body></html1>") ; 








这 里 对 类 中 的 代码 进行 了 整理 ， 以 便于 阅读 ， 
并 删除 了 Razor 在 生成 类 时 为 检测 而 添加 的 一 些 C# 
语句 。 后 面 将 深入 天 析 类 ， 并 解释 编译 视图 的 工作 
原理 。 





以 前 很 容易 查看 早期 版 本 的 Razor 创 建 的 类 ， 

因为 每 个 视图 都 会 在 磁盘 上 生成 一 个 C# 文 件 ， 然 后 

进行 编译 以 便 在 应 用 程序 中 使 用 。 检 查 类 的 内 容 只 
是 为 了 找到 正确 的 文件 。 当 前 版 本 的 Razor 依 赖 于 
C# 编 译 器 的 进步 ， 人 允许 在 内 存 中 生成 和 编译 代码 ， 
从 而 提高 性 能 ， 但 很 难看 到 正在 执行 的 事情 。 要 获 
得 以 前 显示 的 类 ， 将 不 得 不 重新 使 用 ASP.NET Core 
MVC 源 代码 中 包含 的 一 些 单 元 测试 ， 其 中 提供 了 
Razor 依 赖 于 查找 和 处 理 视图 文件 的 类 的 模拟 实 
现 。 这 不 是 日 党 开发 中 需要 做 的 事情 ， 但 揭示 了 视 
图 如 何 工作 。 














1. 理解 类 的 名 称 


我 们 和 完 从 Razor 创 建 的 类 的 名 称 开始 。 


public class ASPV_Views_Home_Index_cshtml : RazorPage<s 
tring[]> { 








Razor 需 要 使 用 一 些 方 法 来 将 CSHTML 文 件 的 
名 称 和 路 径 转换 为 分 析 文 件 时 创建 的 类 ， 并 通过 对 
类 名 称 中 的 信息 进行 编码 来 实现 。Razor 使 用 ASPV 
i 
是 视图 文件 名 ; 这 种 组 合 使 得 当 MVC 通 Hll n 
摘 述 的 [ViewEngine 请 求 视 图 时 ， 可 以 轻松 检查 
是 否 可 用 。 








N 


FER 


Razor 的 很 多 核心 功能 ， 比 如 能 够 以 @Model 的 
形式 引用 视图 模型 ， 比 于 它们 派生 自 其 类，。 





public class ASPV Views Home Index cshtml : RazorPage<s 





tring[]> { 





由 于 @model 指 令 已 用 于 指定 模型 类 型 ， 因 此 
View 类 继承 日 RazorPage 类 或 RazorPage<T> 类 。 
RazorPage 类 提供 了 让 CSHTML 文 件 访问 MVC 功 能 
的 方法 和 属性 ， 其 中 有 用 的 RazorPage 属 性 和 方法 


分 别 如 表 21-6 和 表 21-7 所 示 。 








表 21-6 视图 开发 中 有 用 的 RazorPage 属 性 









































返回 由 操作 方法 提供 的 模型 数据 
返回 一 个 ViewDataDictionary 对 象 ， 该 对 象 提供 对 其 他 视图 数据 功能 的 访问 
返回 一 个 ViewContext 对 象 








用 于 指定 布局 
omes fen 个 描述 当前 请 求 和 正在 准备 的 响应 的 HttpContext 对 象 












































User 返回 与 请 求 相 关联 的 用 户 的 配置 文件 


421-7 视图 开发 中 有 用 的 RazorPage 方 法 








用 于 将 视图 中 的 一 部 分 内 容 插 入 布局 
AF RAGS EMA (section) 中 的 视图 的 所 有 内 容 插入 布局 
日 于 确定 视图 是 否定 义 部 分 的 内 容 

















Razor Pages 


随 着 ASP.NET Core 2 的 发 布 ， 微 软 增加 了 对 
Razor Pages 的 文 持 ，Razor Pages 打 破 了 MVC 模 型 ， 
并 将 支持 视图 所 和 需 的 代码 与 Razor 视 图 相关 联 。 这 
类 似 于 ASP.NET Web Forms， 是 微软 尝试 的 一 种 设 
计 方 法 ， 用 于 重新 获得 Web Pages 平 台 的 简单 性 ， 


而 不 会 出 现 第 1 章 所 述 的 缺点 。 


不 要 将 本 节 中 描述 的 RazorPage 基 类 与 Razor 
Pages 的 功能 和 型 混淆。 虽然 它们 使 用 相似 的 名 称 ， 
但 RazorPage 基 类 为 MVC 框 架 使 用 的 Razor 视 图 引擎 
提供 了 基础 。 本 书 没有 介绍 Razor Pages， 因 为 它 不 
从 合 MVC 模 型 ， 也 不 是 MVC 平 台 的 一 部 分 。 


Razor 还 提供 了 一 些 可 以 在 视图 中 用 于 生成 内 
容 的 辅助 属性 ， 如 表 21-8 所 示 。 


表 21-8 ”Razor 辅 助 属性 


HtmlEncoder | 返回 一 个 HtmlEncoder 对 象 ， 可 用 于 在 视图 中 安全 地 对 HTML 内 容 进行 编码 





om [am rnas 


Json 返回 一 个 JSON 助 手 

















返回 一 个 URL 辅 助 器 ， 可 用 于 使 用 路 由 配置 生成 URL 









































返回 一 个 HTML 助 手 ， 可 用 于 生成 动态 内 容 。 此 功能 已 被 标签 助手 取代 ， 但 























仍然 用 于 分 部 视 攻 














表 21-6 和 表 21-8 中 描述 的 属性 在 日 常 MVC 开 发 
中 访问 模型 数据 、 配 置 视 图 和 执行 其 他 重要 任务 时 
会 用 到 。 这 些 属性 揭 开 了 Razor 的 神秘 面纱 ， 并 将 
Razor 牢 牢 地 置 于 为 人 熟知 的 C# 志 界 中 。 例 如 ， 妆 
使 用 @Model 指 令 访 问 视 图 模型 对 象 或 使 用 
@TempData 检 索 临 时 数据 值 时 ， 就 会 用 到 由 
RazorPage 关 定义 的 属性 。 








除了 回 开 及 人 员 提 供 属 性 和 方 读 外 ， 
RazorPage 类 还 负责 通过 ExecuteAsyc 方 法 生成 响应 
内 容 。 议 方法 显示 了 Razor 如 何 将 mdex.cshtml 文 件 
处 理 成 一 组 C# 语 句 : 





public override async Task ExecuteAsync() { 
Layout = null; 
WriteLiteral(@"<!DOCTYPE html><html><head> 
<meta name=""viewport"" content=""width=dev 
ice-width"" /> 
<title>Razor</title> 
<link asp-href-include=""lib/bootstrap/dist 
/css/*.min.css"" 
rel=""stylesheet"" /> 
</head><body class=""m-1 p-1"">This is a li 
st of fruit names:"); 
foreach (string name in Model) { 
WriteLiteral("<span><b>"); 
Write(name) ; 
WriteLiteral("</b></span>") ; 


WriteLiteral("</body></html>") ; 





数据 值 《 如 Model 属 性 的 值 ) 将 使 用 Write 方法 
RUSBY itt, VATE PAB MEX a 
不 将 其 解释 为 HTML 元 素 。 这 很 重要 ， 因 为 可 以 防 
止 恶意 数据 值 回应 用 程序 的 输出 诬 加 内 容 。 
WriteLiteral 方 法 不 会 转 义 字符 串 ， 并 且 被 用 于 
Index.cshtml 文 件 中 的 静态 内 容 。 当 然 ， 浏 览 右 应 议 














将 其 解释 为 HIML 元 素 。 结 果 是 CSHTML 文 件 的 静 
态 和 动态 内 容 包 含 在 常规 C# 类 中 ， 并 通过 简单 的 方 
TERA 





21.4 SISA Ais NF Razorih AF 


视图 的 整个 目的 是 让 你 能 够 将 域 模 型 的 一 部 分 
呈现 给 用 户 。 为 此 ， 你 需要 能 够 问 视 图 添加 动态 内 
容 。 动 态 内 容 在 运行 时 生成 ， 每 个 请 求 都 可 以 是 不 
同 的。 这 与 你 在 编写 应 用 程序 时 创建 的 对 于 每 个 请 
求 都 相同 的 静态 内 容 〈 例 如 HIML ) 相反。 可 以 按 
照 表 21-9 中 描述 的 不 同方 式 同 视图 中 添加 动态 内 
容 。 

















表 21-9 ”将 动态 内 容 添 加 到 视图 中 的 方式 








方式 何 时 使 用 


用 于 小 型 、 独 立 的 视图 逻辑 ， 如 if 和 foreach 语 句 。 这 是 在 视图 中 创建 动态 内 容 









































内 联 代码 ”| 的 基础 工具 ， 其 他 一 些 方 法 便 以 此 为 基础 。 第 5 章 介 绍 了 这 种 技术 ， 你 在 以 后 
的 章节 中 也 将 看 到 很 多 这 样 的 例子 
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(section ) 

















用 于 创建 将 在 特定 位 置 插 入 布局 的 内 容 部 分 ， 如 本 节 后 面 所 述 











用 于 在 视图 之 间 共 享 视图 标记 。 分 部 视图 可 以 包含 内 联 代码 、HTML 和 辅助 方法 
和 其 他 分 部 视图 的 引用 。 分 部 视图 不 会 调用 操作 方法 ， 因 此 不 能 用 于 执行 业 
务 逻 辑 

































































用 于 创建 可 重用 的 UI 控 件 或 需要 包含 业务 逻辑 的 窗口 小 部 件 








21.4.1 使 用 布局 部 分 


Razor 视 岁 引 擎 文 持 部 分 〈section) 的 概念 ， 以 
允许 在 布局 中 提供 内 容 区 域 。 部 分 可 以 更 好 地 控制 
将 视图 的 哪些 内 容 插入 布局 以 及 放置 在 哪里 。 为 了 
演示 部 分 的 功能 ， 编 辑 /Views/Home/Index.cshtml 文 
件 ， 如 代码 清单 21-12 所 示 。 


代码 清单 21-12” 在 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 中 


定义 部 分 


@model string[ ] 
@{ Layout = " Layout"; } 


@section Header { 
<div class="bg-success"> 
@foreach (string str in new [] {"Home", "List", 
"Edit"}) { 
<a class="btn btn-sm btn-primary" asp-actio 
n="str">@str</a> 
} 
</div> 
} 
This is a list of fruit names: 
@foreach (string name in Model) { 
<span><b>@name</b></span> 


} 


@section Footer { 
<div class="bg-success"> 
This is the footer 
</div> 





BYALA ne S—HBHTMLICA, FRE 
了 Layout 属 性 ， 以 指定 使 用 名 为 _Layout.cshtml 的 布 
局 文件 来 呈现 内 容 。 











这 里 还 在 视图 中 添加 了 一 些 部 分 。 部 分 使 用 
Razor @section 表 达 式 定义 ， 后 跟 部 分 的 名 称 。 此 


外 创建 了 标题 和 页 脚 部 分 ， 内 容 是 HTML 标记 和 
Razor 表 达 式 的 组 合 ， 其 他 示例 中 已 经 展示 过 这 些 


组 合 。 





部 分 在 视图 中 定义 ， 但 应 用 于 市 有 
(@RenderSection 表 达 式 的 布局 。 为 了 演示 原理 ， 创 
建 Views/Shared 文 件 夹 ， 并 添加 一 个 名 为 
_Layout.cshtml 的 布局 文件 ， 内 容 如 代码 清单 21-13 
所 示 。 














代码 清单 21-13 ”Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 件 
的 内 容 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 
<title>@ViewBag.Title</title> 
<link asp-href-include="1lib/bootstrap/dist/css/*.mi 
n.css" rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
@RenderSection( "Header" ) 


<div class="bg-info"> 
This is part of the layout 
</div> 


@RenderBody( ) 
<div class="bg-info"> 
This is part of the layout 


</div> 


@RenderSection( "Footer" ) 


<div class="bg-info"> 
This is part of the layout 
</div> 
</body> 
</html> 





当 Razor 解 析 布 局 时 ，RenderSection 辅 助 程 序 
将 被 视 图 中 具有 指定 名 称 的 部 分 的 内 容 奉 换 。 不 包 
舍 部 分 的 视图 内 容 已 使 用 RenderBody 助 手 插 入 布 
局 。 








0 


可 以 通过 局 动 应 用 程序 来 看 到 这 些 部 分 的 效 
果 ， 如 图 21-5 所 示 。 这 里 使 用 一 些 Bootstrap 样 式 来 
帮助 看 清楚 哪些 部 分 (section) 来 自视 图 ， 而 哪些 





来 目 输 出 。 结 果 不 是 很 漂 完 ， 但 它 演示 了 如 何 将 视 
图 中 的 内 容 区 域 放 在 布局 中 的 特定 位 置 。 











This is a list of fruit names: Apple Orange Pear 














图 21-5 ”使 用 视图 中 的 部 分 来 定位 布局 中 的 内 容 


E 


y> ae. 
ee Oe 





视图 只 能 定义 布局 中 引用 的 部 分 。 如 果 壬 试 在 
视图 中 定义 布局 中 没有 对 应 的 @RenderSection 表 达 
式 的 部 分 ，MVC 将 显示 异常 。 





将 部 分 与 其 余 视图 混合 是 不 正常 的 。 约 定 古 在 
视图 的 开始 或 结尾 定义 部 分 ， 以 便 更 容易 看 到 哪些 
内 容 区 域 将 被 视 为 部 分 ， 哪 些 内 容 将 家 RenderBody 
助手 捕获 。 另 一 种 方式 是 仅 使 用 部 分 来 定义 视图 ， 
包括 用 于 正文 的 部 分 ， 如 代 但 清单 21-14 所 示 。 








代码 清单 21-14 在 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 中 
根据 Razor 部 分 定义 视图 





@model string[ ] 
@{ Layout = " Layout"; } 


@section Header { 
<div class="bg-success"> 
@foreach (string str in new [] {"Home", "List", 
"Edit"}) { 
<a class="btn btn-sm btn-primary" asp-actio 
n="str">@str</a> 
} 
</div> 
} 
@section Body { 
This is a list of fruit names: 
@foreach (string name in Model) { 
<span><b>@name</b></span> 


} 


@section Footer { 
<div class="bg-success"> 
This is the footer 
</div> 





这 样 做 可 以 提供 更 清晰 的 视图 ， 并 减少 
RenderBody 捕 获 无 关内 容 的 机 会 。 要 使 用 这 种 方 
法 ， 就 必须 将 RenderBody 调 用 蔡 换 为 
RenderBody("body")， 如 代码 清单 21-15 所 示 。 





代码 清单 21-15 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 将 Body 演 染 为 部 分 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 
<title>@ViewBag.Title</title> 
<link asp-href-include="1lib/bootstrap/dist/css/*.mi 
n.css" rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
@RenderSection( "Header" ) 


<div class="bg-info"> 
This is part of the layout 
</div> 


@RenderSection("Body" ) 
<div class="bg-info"> 
This is part of the layout 


</div> 


@RenderSection( "Footer" ) 


<div class="bg-info"> 
This is part of the layout 
</div> 
</body> 
</html> 





1. Maho 





可 以 检查 视图 是 否 从 布局 中 定义 了 特定 的 部 
分 。 如 果 视 图 不 需要 或 想 要 提供 特定 的 内 容 ， 可 以 
为 部 分 提供 默认 内 容 。 修 改 _Layout.cshtml 文 件 ， 以 
检查 是 否定 义 了 页 脚 部 分 ， 如 代码 清单 21-16 所 
示 。 











代码 清单 21-16 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 


件 中 检查 是 否定 义 了 茶 个 部 分 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>@ViewBag.Title</title> 
<link asp-href-include="1lib/bootstrap/dist/css/*.mi 
n.css" rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
@RenderSection( "Header" ) 


<div class="bg-info"> 
This is part of the layout 
</div> 


@RenderSection( "Body" ) 


<div class="bg-info"> 
This is part of the layout 
</div> 


@if (IsSectionDefined("Footer")) { 
@RenderSection("Footer" ) 
} else { 
<h4>This is the default footer</h4> 
} 


<div class="bg-info"> 
This is part of the layout 
</div> 
</body> 


IsSectionDefined 助 手 用 于 获取 要 检查 的 部 分 的 
名 称 ， 如 采 在 泻 染 的 视图 中 定义 该 部 分 ， 则 返回 
true。 在 该 例 中 ， 可 使 用 该 助手 来 确定 在 视图 未 定 
义 页 脚 部 分 时 是 否 应 该 呈现 一 些 默 认 内 容 。 











2， 演 染 可 选 部 分 


add. 


默认 情况 下 ， 视 图 必须 包含 布 局 中 有 
RenderSection 调 用 的 所 有 部 分 。 如 采 缺 少 部 分 ， 那 
AMVC PR AN Sia, WA 
_Layout.cshtml 文 件 添 加 一 个 新 的 RenderSection 调 
用 ， 用 于 名 为 scripts 的 部 分 ， 如 代码 清单 21-17 上 所 
示 。 








代码 清单 21-17 在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 泻 染 某 个 不 存在 的 部 分 


<!DOCTYPE html> 
<html> 





<head> 

<meta name="viewport" content="width=device-width" 
/> 

<title>@ViewBag.Title</title> 

<link asp-href-include="1ib/bootstrap/dist/css/*.mi 
n.css" rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 

@RenderSection( "Header" ) 


<div class="bg-info"> 
This is part of the layout 
</div> 


@RenderSection( "Body" ) 


<div class="bg-info"> 
This is part of the layout 
</div> 


@if (IsSectionDefined("Footer")) { 
@RenderSection( "Footer" ) 

} else { 
<h4>This is the default footer</h4> 


} 


@RenderSection("scripts") 


<div class="bg-info"> 
This is part of the layout 
</div> 
</body> 
</html> 





当局 ee ae Se Ae Be Tp Ja 
和 视图 时 ， 会 显示 图 21-6 所 示 的 错误 。 





BE ey pie 


图 21-6” 当 缺少 部 分 时 显示 错误 
可 以 使 用 IsSectionDefined 方法 避免 对 视图 未 
定义 的 部 分 进行 RenderSection 调 用 ， 但 更 好 的 方法 
是 使 用 可 选 部 分 ， 也 就 是 癌 RenderSection 方 法 传递 
一 个 额外 的 虚假 参数 ， 如 代码 清单 21-18 所 示 。 


代码 清单 21-18 制作 可 选 部 分 





@RenderSection("scripts", false) 


这 将 创建 一 个 可 选 部 分 ， 如 果 视 图 定义 了 该 部 


ay, MIEARMABAH; BV, ARIRE H o 





21.4.2 ”使 用 分 部 视图 











通常 需要 在 应 用 程序 的 多 个 不 同位 置 使 用 相同 
的 Razor 标 答 和 HTML 标 记 。 可 以 使 用 分 部 视图 ， 而 
并 非 总 是 将 内 容 复制 一 份 ， 分 部 视图 是 单独 的 视图 
文件 ， 其 中 包含 可 包含 在 其 他 视图 中 的 标记 。 本 市 
将 展示 如 何 创建 和 使 用 分 部 视图 ， 解 释 它 的 工作 原 
理 ， 并 演示 将 视图 数据 传递 到 分 部 视图 的 方法 。 


1. 创建 分 部 视图 


分 部 视图 只 是 和 常规 的 CSHTML 文 件 ， 你 需要 将 
它们 与 常规 Razor 视 图 区 分 开 来 。Visual Studio 为 创 
建 预 制 的 分 部 视图 提供 了 一 些 文 持 工 具 ， 但 创建 分 
部 视图 的 最 简单 方法 是 使 用 MVC View Page 模 板 创 
建 第 规 视图 。 为 了 演示 ， 在 Views/Home 文 件 炎 中 添 








加 一 个 名 为 MyPartial.cshtml 的 文件 ， 并 添加 代码 清 
单 21-19 所 示 的 内 容 。 


代码 清单 21-19 ”Views/Home 文 件 夹 下 的 MyPartial.cshtml 文 件 
的 内 容 


<div class="bg-info"> 
<div>This is the message from the partial view.</di 


v> 

<a asp-action="Index">This is a link to the Index a 
ction</a> 
</div> 





a = | 
个 使 用 标签 助 a f 











可 通过 从 男 一 个 视图 中 调用 @ Html.Partial 表 达 
式 来 使 用 分 部 视图 。 为 了 演示 ， 在 Views/Home 文 件 
夹 中 添加 一 个 名 为 List.cshtml 的 新 文件 ， 并 添加 代 


人 码 清单 21-20 所 示 的 内 容 。 


代码 清单 21-20 ”Views/Home 文 件 夹 下 的 List.cshtml 文 件 的 内 容 


@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Razor</title> 
<link asp-href-include="1lib/bootstrap/dist/css/*.mi 
n.css" rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
This is the List View 
@Html.Partial("MyPartial" ) 
</body> 
</html> 





Partial 方 法 是 一 种 扩展 方法 ， 被 应 用 于 添加 到 
Razor 从 视图 文件 生成 的 类 的 Html 属 性 。 这 是 一 个 
HTML 助 手 ， 在 MVC 早 期 版 本 中 站 是 在 视图 中 生成 
动态 内 容 的 方式 ， 但 大 部 分 已 被 标签 助手 葵 代 。 传 
着 给 Partial 方 法 的 参数 是 分 部 视图 的 名 称 ， 分 部 视 











图 的 内 容 被 插入 友 送 到 客户 并 的 输出 。 


人 


fe 7S 
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可 以 通过 局 动 应 用 程序 并 导航 到 URL 
/Home/List 来 查看 分 部 视图 的 使 用 效 末 ， 如 图 21-7 
所 示 。 


口 Razor 
S C | © localhost61386/Home/List 


This is the List View 





图 21-7 ”使 用 分 部 视图 
3. 使 用 强 疾 型 的 分 部 视图 


可 以 创建 强 类 型 的 分 部 视图 ， 并 提供 在 呈现 分 
部 视图 时 使 用 的 视图 模型 对 象 。 为 了 演示 此 功能 ， 
可 在 Views/Home 文 件 严 中 创建 一 个 新 的 名 为 
MyStronglyTypedPartial.cshtml 的 视图 文件 并 添加 代 
码 清单 21-21 所 示 的 内 容 。 


代码 清单 21-21 Views/Home 文 件 夹 下 的 
MyStronglyTypedPartial.cshtml 文 件 的 内 容 





@model IEnumerable<string> 


<div class="bg-info"> 
This is the message from the partial view. 
<ul> 
@foreach (string str in Model) { 
<li>@str</1i> 


} 
</ul> 
</div> 


视图 模型 类 型 使 用 标准 @model 表 达 式 来 定 
义 ， 这 里 使 用 @foreach 循 环 将 视图 模型 对 象 的 内 容 
显示 为 HTML 代 人 码 清 单 中 的 条 目 。 为 了 演示 如 何 使 
用 这 个 分 部 视图 ， 更 新 /Views/Common/List.cshtml 
文件 ， 如 代码 清单 21-22 所 示 。 





代码 清单 21-22 Views 人 Common 文 件 夹 下 的 List.cshtml 文 件 的 
内 容 





@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Razor</title> 
<link asp-href-include="1lib/bootstrap/dist/css/*.mi 
n.css" rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
This is the List View 
@Html1.Partial("MyStronglyTypedPartial", 
new string[] { "Apple", "Orange", "Pear" }) 


</body> 
</html> 


与 上 一 个 示例 的 区 别 在 于 ， 这 里 将 一 个 额外 的 
参数 传递 给 提供 视图 模型 的 Partial 辅 助 方法 。 可 以 
通过 局 动 应 用 程序 和 导航 到 URL 一 一 /Home/List 来 
查看 使 用 的 强 类 型 的 分 部 视图 ， 如 图 21-8 所 示 。 











图 21-8 ”使 用 强 类 型 的 分 部 视图 
21.4.3 ”将 JSON 内 容 添加 到 视图 中 


视图 中 经 常 包含 JSON， 以 便 为 客户 端 
JavaScript 代 码 提 供 可 用 于 动态 生成 内 容 的 数据 。 为 
了 准备 这 个 例子 ， 可 通过 编辑 bower.json 文 件 将 
jQuery 包 琴 加 到 应 用 程序 中 ， 如 代码 清单 21-23 所 


示 ， 这 将 使 浏览 器 更 容易 处 理 作 为 HTML 文 档 的 一 
部 分 接收 的 JSON 数 据 。 


代码 清单 21-23 ”在 bower.json 文 件 中 添加 jQuery 


{ 


"name": "asp.net", 
"private": true, 
"dependencies": { 


"bootstrap": "4.0.0-alpha.6", 
"jquery": "3.2.1" 
} 





} 


代码 清单 21-24 显 示 了 List.cshtml 视 图 文件 的 新 
增 功能 ， 该 视图 使 用 Razor 在 发 送 到 浏览 器 的 响应 
中 包含 JSON 数 据 。 


代码 清单 21-24 在 Views 人 /Common 文 件 夹 下 的 List.cshtml 文 件 
中 使 用 JSON 数 据 





@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 


<meta name="viewport" content="width=device-width" 
/> 

<title>Razor</title> 

<link asp-href-include="1lib/bootstrap/dist/css/*.mi 
n.css" rel="stylesheet" /> 

<script id="jsonData" type="application/json"> 

@Json.Serialize(new string[] { "Apple", "Orange 

", "Pear" }) 

</script> 
</head> 
<body class="m-1 p-1"> 

This is the List View 

<ul id="list"></ul> 
</body> 
</html> 





@Json.Serialize 表 达 式 接收 一 个 对 象 并 将 其 序 
列 化 为 JSON 格 式 。 以 上 代码 已 经 在 包含 JSON 数 据 
的 视图 中 添加 了 一 个 script 元 素 。 当 视图 被 呈现 并 发 
送 到 浏览 锅 时 ， 其 中 包含 如 下 元 素 : 











<script id="jsonData" type="application/json">[ "Apple", 


"Orange", "Pear" |</script> 








为 了 利用 JSON 数 据 ， 代 人 码 清单 21-25 添 加 了 
jQuery 库 和 一 些 JavaScript 代 码 ， 这 些 代码 使 用 


jQuery 来 解析 JSON 数 据 并 动态 创建 一 些 HTML 元 
A: 


代码 清单 21-25 “在 Views/Common 文 件 夹 下 的 List.cshtml 文 件 
中 使 用 JSON 数 据 





@{ Layout = null; } 
<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Razor</title> 
<link asp-href-include="1lib/bootstrap/dist/css/*.mi 
n.css" rel="stylesheet" /> 
<script id="jsonData" type="application/json"> 
@Json.Serialize(new string[] { "Apple", "Orange 
", "Pear" }) 
</script> 
<script asp-src-include="lib/jquery/dist/*.min.js"> 
</script> 
<script type="text/javascript"> 
$(document).ready(function () { 
var list = $("#list") 
JSON. parse($("#jsonData").text()).forEach(f 
unction (val) { 
console.log("Val: " + val); 
list.append($("<1li>").text(val)); 
}); 
}); 


</script> 


</head> 

<body class="m-1 p-1"> 
This is the List View 
<ul id="list"></ul> 

</body> 

</html> 





如 各 运行 示例 应 用 程序 并 请 求 URL 
/Home/List， 就 会 显示 图 21-9 所 示 的 内 容 。 这 不 是 
JSON 数 据 最 重要 的 使 用 方法 ， 但 它 显 示 了 如 何 将 
JSON 数 据 包含 在 视图 中 。 





[} Razor 


€ C |© localhost 


This is the List View 





图 21-9 在 视图 中 使 用 JSON 数 据 
21.5 配置 Razor 


可 以 使 用 Microsoft.AspNetCore.Mvc.Razor 命 名 
空间 中 定义 的 RazorViewEngineOptions 类 来 配置 


Razor。 该 类 定义 了 两 个 配置 属性 ， 如 表 21-10 上 所 
ae 


表 21-10 ”RazorViewEngineOptions 类 定义 的 配置 属性 


配置 属性 


FileProvider 








用 于 设置 为 文件 和 目录 提供 Razor 的 对 象 ， 由 
Microsoft.AspNetCore.FileProviders.IFileProvider 接 口 定 义 ， 





默认 由 


从 磁盘 读 取 文件 的 PhysicalFileProvider 实 现 


用 于 配置 视图 扩展 ， 用 于 更 改 Razor 查 找 视 图 的 方式 


o 











=a 
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如 果 想 深入 学 习 ， 那 么 可 以 通过 创建 实现 了 
Microsoft.AspNetCore.Mvc.Razor 命 名 空间 中 接口 的 


类 来 将 换 内 部 Razor 组 件 ， 并 注册 到 Startup 类 中 的 





service provider。 但 大 多 数 开 友 人 员 并 不 需要 这 人 么 
做 ， 但 如 果 项 望 完 全 控制 应 用 程序 中 内 容 的 处 理 方 
式 ， 那 么 这 是 一 个 很 有 用 的 方式 。 可 以 从 GitHub 下 
载 Razor 的 源 代码 作为 开始 。 





许多 应 用 程序 不 需要 更 改 FileProvider 属 性 ， 
为 从 磁盘 读 取 视图 文件 正 是 大 多 数 项 目 所 需要 的 ， 
而 Razor 仅 使 用 service provider 来 加 载 视图 ， 以 便 在 
应 用 程序 首次 运行 时 进行 编 详 。 
ViewLocationExpanders 属 性 更 有 用 ， 因 为 它 允 许 应 
用 程序 将 自 定 义 馆 辑 应 用 于 Razor 否 看 视图 的 方 
ate 


视图 位 置 扩 展 





Razor 使 用 视图 位 置 扩展 来 构建 应 该 搜索 视图 
AKA. MAMAS EKI I 





IViewLocationExpander 接 口 ， 该 接口 的 定义 如 下 : 


using System.Collections.Generic; 


namespace Microsoft.AspNetCore.Mvc.Razor { 


public interface IViewLocationExpander { 


void PopulateValues(ViewLocationExpanderContext 
context) ; 


TEnumerable<string> ExpandViewLocations (ViewLoc 
ationExpanderContext context, 
TEnumerable<string> viewLocations) ; 


} 





接 下 来 解释 视图 位 置 扩展 的 工作 原理 ， 并 创建 
IViewLocationExpander 接 口 的 自 定 义 实 现 。 为 了 准 
备 创 建 视图 位 置 扩 展 ， 代 码 清单 21-26 已 经 更 改 了 
Home 控 制 器 的 Index 操 作 方 法 ， 以 便 请 求 不 存在 的 
视图 。 视 图 不 存在 的 错误 消息 将 显示 Razor 搜 索 视 
图 的 位 置 以 及 视图 位 置 扩 展 市 来 的 影响 。 

















代码 清单 21-26 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 


件 中 请 求 不 存在 的 视图 


using System; 
using Microsoft.AspNetCore.Mvc; 


namespace Views.Controllers { 


public class HomeController : Controller { 


public ViewResult Index() => 
View("MyView", new string[] { "Apple", "Ora 
nge", "Pear" }); 


public ViewResult List() => View(); 





如 果 局 动 应 用 程序 并 请 求 默 认 URL， 你 将 看 到 
普 误 消息 中 显示 的 默认 视图 搜索 位 置 ， 如 下 所 未: 


/Views/Home/MyView. cshtml 
/Views/Shared/MyView. cshtml 


1. 创建 简单 的 视图 位 置 扩 展 








最 简单 的 视图 位 置 扩展 只 需要 更 改 Razor 奏 找 
视图 的 位 置 集合 。 这 可 以 通过 实现 





ExpandViewLocations 方 法 并 返回 要 文 持 的 位 置 清单 
来 完成 。 为 了 演示 ， 在 Infrastructure 文 件 夹 中 添加 
一 个 名 为 SimpleExpander.cs 的 类 文件 ， 内 容 如 代码 
清单 21-27 所 示 。 


代码 清单 21-27 Infrastructure 文件 夹 下 的 SimpleExpander.cs 文 
件 的 内 容 





using System.Collections.Generic; 
using Microsoft.AspNetCore.Mvc.Razor; 


namespace Views.Infrastructure { 


public class SimpleExpander : IViewLocationExpander 


public void PopulateValues(ViewLocationExpander 
Context context) { 


// do nothing - not required 


} 

public IEnumerable<string> ExpandViewLocations( 
ViewLocationExpanderContext context, 
TEnumerable<string> viewLocations) { 


foreach (string location in viewLocations) 


yield return location.Replace("Shared", 
"Common" ) ; 


} 
yield return "/Views/Legacy/{1}/{0}/View.cs 





当 需 要 搜索 位 置 清单 时 ，Razor 会 调用 
ExpandViewLocations 方 法 ， 并 且 使 用 viewLocations 
参数 中 的 一 系列 字符 串 提 供 默 认 位 置 。 位 置 表示 为 
带 有 占 位 符 的 模板 ， 占 位 符 用 于 指 代 操作 方法 和 控 
制 辟 的 名 称 。 以 下 是 在 不 使 用 路 由 区 域 的 应 用 程序 
中 默认 使 用 的 位 置 模板 : 








"/Views/{1}/{0}.cshtml1" 


"/Views/Shared/{@}.cshtml" 





占 位 符 {0} 用 于 指 代 操作 方法 的 名 称 ， 占 位 符 
用 于 指 代 {1} 控 制 器 的 名 称 。 视 图 位 置 扩 展 的 作用 
是 返回 应 被 搜索 的 位 置 集合 ， 可 使 用 string.Replace 
方法 在 默认 位 置 中 更 改 Shared 为 Common， 并 添加 
目 己 的 位 置 ， 位 置 将 遭 循 不 同 的 文件 和 文件 夹 结 


构 。 


代码 清单 21-28 通 过 在 Startup 类 中 配置 Razor 来 
设置 视图 位 置 扩展 。ViewLocationExpanders 属 性 会 
返回 一 个 在 其 中 调用 Add 方 法 的 List 
<IViewLocationExpander> 对 象 。 


代码 清单 21-28 在 Startup.cs 文 件 中 配置 Razor 





using System; 

using System.Collections.Generic; 
using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 
using Microsoft.AspNetCore.Hosting; 
using Microsoft.AspNetCore.Http; 
using Microsoft.Extensions.DependencyInjection; 
using Microsoft.AspNetCore.Mvc; 

using Views.Infrastructure; 

using Microsoft.AspNetCore.Mvc.Razor; 


namespace Views { 
public class Startup { 
public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 
services.Configure<RazorViewEngineOptions>( 
options => { 
options.ViewLocationExpanders.Add(new S 


impleExpander()); 


}); 
} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 








UWR R ER ER Be XA 
位 置 扩 展 提 供给 Razor 的 位 置 集合 。 


/Views/Home/MyView. cshtml 
/Views/Common/MyView. cshtml 





/Views/Legacy/Home/MyView/View.cshtml 


2. 为 请 求 选择 特定 视图 


视图 位 置 扩 展 可 以 轻松 更 改 所 有 请 求 的 检索 位 
置 ， 也 可 以 更 改 单个 请 求 的 搜索 位 置 。 前 面 的 例子 
仅 实 现 了 ExpandViewLocations 方 法 ， 但 实际 作用 来 


X» 文 


目 PopulateValues 方 法 ， 这 是 IViewLocationExpander 


LORDAI e 


Razor 每 次 需要 一 个 视图 时 ， 束 会 调用 视图 位 
置 扩展 的 PopulateValues 方 法 ， 为 上 下 文 数 据 提 供 一 
个 ViewLocationExpanderContext 对 象 。 表 21-11 显 示 
了 ViewLocationExpanderContext 类 定义 的 属性 


表 21-11 ViewLocationExpanderContext 类 定义 的 属性 

































































返回 一 个 ActionContext 对 象 ， 用 于 描述 已 请 求 视图 的 操作 方法 ，3 
关 请 求 和 响应 的 详细 信息 


psn | 回 操作 方法 请 求 的 视图 的 名 称 














ActionContext 



































E 
eee 
rag emery 视图 ， 就 返回 false; 否则， 返回 true 


回 一 个 IDictionary<string,string> 对 象 ， 视 图 位 置 扩 展会 添加 唯一 标识 请 
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Values 求 类 别 的 键 / 值 对 ， 具 体 将 在 下 面 的 内 容 中 介绍 








PopulateValues 方 法 的 目的 是 通过 为 Context 对 
象 的 Values 属 性 返回 的 字典 添加 键 / 值 对 来 对 请 求 分 
类 。Razor 不 管 请 求 如 何 分 类 ， 用 于 填充 字典 的 方 
法 都 完全 留 给 视图 位 置 扩 展 ， 这 很 容易 通过 一 个 例 
子 来 解释 。 将 一 个 名 为 ColorExpander.cs 的 类 文件 添 
加 到 Infrastructure 文 件 夹 中 ， 并 用 它 定 义 代码 清单 
21-29 所 示 的 类 。 














代码 清单 21-29 Infrastructure 文件 夹 下 的 ColorExpander.cs 文 件 
的 内 容 





using System.Collections.Generic; 
using Microsoft.AspNetCore.Mvc.Razor; 


namespace Views.Infrastructure { 
public class ColorExpander : IViewLocationExpander 
private static Dictionary<string, string> Color 
= new Dictionary<string, string> { 


["red" ] 一 "Red", ["green" ] 一 "Green", [ 
"blue" | = "Blue" 


}; 


public void PopulateValues(ViewLocationExpander 
Context context) { 


var routeValues = context.ActionContext.Rou 
teData.Values; 
string color; 


if (routeValues.ContainsKey("id") 
&& Colors.TryGetValue(routeValues[" 
id"] as string, out color) 
&& !string.IsNullOrEmpty(color)) { 
context.Values["color"] = color; 


} 


public IEnumerable<string> ExpandViewLocations( 
ViewLocationExpanderContext context, 
IEnumerable<string> viewLocations) { 
string color; 
context.Values.TryGetValue("color", out col 


or); 
foreach (string location in viewLocations) 
{ 
if (!string.IsNullOrEmpty(color)) { 
yield return location.Replace("{@}" 
» color); 


} else { 
yield return location; 


} 





PopulateValues 方 法 使 用 ActionContext 获 取 路 由 
数据 ， 并 查找 URL 参 数 片 段 id 的 值 。 如 果 有 一 个 id 
FEA AZ. ERKE, MAMET EME 
问 值 字典 添加 Color 属 性 。 在 分 类 的 过 程 中 ，id 片 段 
兄 配 颜色 的 请 求 可 使 用 两 色 键 进行 分 类 ， 颜 色 键 的 
值 由 参数 片段 的 值 定 义 。 








接 下 来 ，Razor 调 用 ExpandViewLocations 方 法 
并 提供 与 PopulateValues 方 法 相同 的 Context 对 象 。 
该 操作 允许 视图 位 置 扩展 但 看 先前 执行 的 分 类 ， 并 
生成 Razor 应 该 查看 的 视图 的 位 置 集合 。 以 上 示例 
使 用 string.Replace 方 法 来 蔡 换 具有 闫 色 名 称 的 {0} 占 
位 符 。 











o 


fe ” 示 


Razor 为 每 个 视图 请 求 调用 PopulateValues 方 
法 ， 但 缓存 由 ExpandViewLocations 方 法 返回 的 搜索 
位 置 集合 。 这 意味 着 PopulateValues 方 法 生成 的 同一 
组 分 类 键 和 值 的 后 续 请 求 不 需要 调用 
ExpandViewLocations 方 法 。 





代码 清单 21-30 已 将 Razor 配 置 为 使 用 


ColorExpander 类 。 


代码 清单 21-30 ”在 Views 文 件 夹 下 的 Startup.cs 文 件 中 添加 视图 
位 置 扩展 





using System; 

using System.Collections.Generic; 
using System.Ling; 

using System. Threading.Tasks; 

using Microsoft.AspNetCore. Builder; 
using Microsoft.AspNetCore.Hosting; 
using Microsoft.AspNetCore.Http; 


using Microsoft.Extensions.DependencyInjection; 
using Microsoft.AspNetCore.Mvc; 

using Views.Infrastructure; 

using Microsoft.AspNetCore.Mvc.Razor; 


namespace Views { 
public class Startup { 
public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 
services.Configure<RazorViewEngineOptions > ( 
options => { 
options.ViewLocationExpanders.Add(new S 
impleExpander()); 
options.ViewLocationExpanders.Add(new C 
olorExpander()); 
})3 
} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 





通过 启动 应 用 程序 并 请 求 URL /Home/Index/red 
可 以 查看 新 的 视图 位 置 扩 展 的 效果 ， 并 使 Razor 同 
时 在 以 下 位 置 进 行 搜 索 : 





/Views/Home/Red.cshtml 
/Views/Common/Red.cshtml 
/Views/Legacy/Home/Red/View. cshtml 


类 似 地 ， 对 URL /Home/Index/green 的 请 求 会 使 
Razor 在 以 下 位 置 进行 搜索 : 


/Views/Home/Green.cshtml 
/Views/Common/Green.cshtml 
/Views/Legacy/Home/Green/View. cshtml 


视图 位 置 扩 展 的 注册 顺序 很 重要 ， 因 为 一 个 视 
图 位 置 扩 展 的 ExpandViewLocations 方 法 生成 的 位 置 
集合 ， 会 家 用 作 清 单 中 下 一 个 视图 位 置 扩 展 的 
viewLocations 参 数 。 从 之 前 显示 的 位 置 可 以 看 到 这 
一 点 ， 其 中 ，Views 人 /Common 和 Views/Legacy 位 置 
由 SimpleExpander 类 生成 ， 访 类 出 现在 Startup 类 中 
的 ColorExpander 之 前 。 





21.6 小结 


本 章 演示 了 如 何 创建 自 定义 视图 引擎 ， 并 通过 
将 CSHITML 文 件 转换 为 C# 关 来 解释 Razor 的 工作 原 
理 。 本 章 还 展示 了 如 何 使 用 布局 部 分 (section〉 和 
分 部 视图 ， 并 讨论 了 如 何 更 改 Razor 用 于 侍 找 视图 
文件 的 位 置 。 下 一 章 将 介绍 用 于 提供 文 持 分 部 视图 
的 逻辑 的 视图 组 件 。 


第 22 章 ”视图 组 件 


本 章 描述 视图 组 件 ， 这 是 ASP.NET Core MVC 
新 增 的 功能 ， 以 蔡 代 以 前 版 本 的 子 action 功 能 。 视 
图 组 件 是 提供 操作 样式 逻辑 以 支持 分 部 视图 的 类 ， 
这 意味 着 可 以 将 复杂 内 容 舱 入 视图 ， 同 时 可 以 方便 
维护 C# 代 码 和 文 持 单元 测试 。 表 22-1 介 绍 了 视图 组 
件 的 背景 。 














4222-1 视图 组 件 的 背景 























视图 组 件 是 提供 应 用 程序 逻辑 以 支持 分 部 视图 或 将 小 部 分 的 HTML 或 
JSON 数 据 注 入 父 视 图 的 类 















































视图 组 件 有 什么 作 ”| 没有 视图 组 件 ， 将 难以 创建 易于 维护 和 支持 单元 测试 的 功能 ， 如 购物 
车 或 登录 面板 

















如 何 使 用 视图 组 视图 组 件 通常 派生 自 ViewComponent 类 ， 并 使 用 @await 
件 ? Component.InvokeAsync 表 达 式 应 用 于 父 视图 
























































中 有 什么 陷 | 没有 ， 视 图 组 件 能 提供 简单 可 靠 的 功能 ， 如 果 不 使 用 视图 组 件 
































局 限 性 ? 中 的 应 用 程序 逻辑 将 会 难以 维护 和 测试 






































可 以 将 数据 访问 和 处 理 逻 辑 直 接 放 在 分 部 视图 
， 难 以 有 效 测试 



















































































表 22-2 列 出 了 本 章 要 介绍 的 操作 。 


表 22-2 ”本章 要 介绍 的 操作 







































































是 供 | 使 用 视图 组 件 



























































图 组 件 | 在 视图 中 使 用 @await Component.InvokeAsync 表 达 式 
































简化 对 上 下 文 
数据 和 结果 的 | 从 ViewComponent 类 派生 
访问 
























































选择 分 部 视图 | 使 用 View 方 法 创建 并 返回 ViewViewComponentResult 对 象 码 清单 22- 





创建 HTML 片 














请 求 的 详 
细 信 息 生 成 结 
































创建 异步 视图 
组 件 























如 果 不 想 要 对 HTML 片段 进行 编码 ， 那 么 返回 Content 方 法 创 
建 的 ContentViewComponentResult 对 象 或 者 明确 地 创建 






































HtmlContentViewComponentResult 对 象 





使 用 视图 组 件 上 下 文 数据 














是 供 InvokeAsync 方 法 的 参数 











实现 InvokeAsync 方 法 并 返回 Tast 对 象 以 得 到 想 要 的 结果 


























将 ViewComponent 属 性 应 用 于 控制 器 类 





22.1 准备 示例 项 目 


19 

























































































































































































在 本 章 中 ， 将 使 用 ASP.NET Core Web 
Application (.NET Core) 模板 创建 一 个 名 为 
UsingViewComponents 的 Empty 项 目 。 


22.1.1 创建 模型 和 存储 库 











这 里 需要 两 个 不 同 的 数据 源 来 演示 视图 组 件 的 
工作 原理 。 为 了 使 部 分 应 用 程序 对 一 组 Product 对 象 
进行 操作 ， 创 建 Models 文 件 来 ， 并 添加 一 个 名 为 
Product.cs 的 文件 ， 用 来 定义 代码 清单 22-1 所 示 的 


Re 


代码 清单 22-1 Models 文 件 夹 下 的 Product.cs 文 件 的 内 容 


namespace UsingViewComponents.Models { 


public class Product { 
public string Name { get; set; } 


public decimal Price { get; set; } 


} 





} 


要 为 Product 对 象 创 建 存 储 库 ， 可 将 一 个 名 为 


ProductRepository.cs 的 文件 添加 到 Models 文 件 夹 
中 ， 并 定义 代码 清单 22-2 所 示 的 接口 和 实现 类 。 





代码 清单 22-2 ”Models 文 件 严 下 的 ProductRepository.cs 文 件 的 
内 容 





using System.Collections.Generic; 


namespace UsingViewComponents.Models { 


public interface IProductRepository { 
IEnumerable<Product> Products { get; } 
void AddProduct(Product newProduct) ; 


} 


public class MemoryProductRepository : IProductRepo 
sitory { 
private List<Product> products = new List<Produ 
ct> { 


new Product { Name "Kayak", Price = 2 
75M }, 


"“Lifejacket", Pric 


new Product { Name 
e = 48.95M }, 


new Product { Name "Soccer ball", Pri 
ce = 19.50M } 


局 


public IEnumerable<Product> Products => product 
S; 


public void AddProduct(Product newProduct) { 


products.Add(newProduct) ; 





IProductRepository 接 口 定 义 了 一 组 有 限 的 存储 
库 功 能 ，MemoryProductRepository 类 使 用 List 实 现 
了 该 接 口 。 为 了 使 应 用 程序 的 其 他 部 分 将 对 City 进 
行 操作 ， 在 Models 文 件 夹 中 添加 一 个 名 为 City.cs 的 
类 文件 ， 并 用 它 定义 代码 清单 22-3 所 示 的 类 。 





代码 清单 22-3 Models 文 件 夹 下 的 City.cs 文 件 的 内 容 


namespace UsingViewComponents.Models { 


public class City { 
public string Name { get; set; } 


public string Country { get; set; } 
public int Population { get; set; } 





对 于 City 对 象 的 存储 库 ， 创 建 一 个 名 为 
CityRepository.cs 的 类 文件 ， 并 用 它 定 义 代码 清单 
22-4 所 示 的 接口 和 实现 类 ，。 





代码 清单 22-4 Models 文 件 夹 下 的 CityRepository.cs 文 件 的 内 容 


using System.Collections.Generic; 
namespace UsingViewComponents.Models { 


public interface ICityRepository { 
TEnumerable<City> Cities { get; } 


void AddCity(City newCity) ; 
} 


public class MemoryCityRepository : ICityRepository 


private List<City> cities = new List<City> { 
new City { Name = "London", Country = "UK", 
Population = 8539000}, 

new City { Name = "New York", Country = "US 
A", Population = 8406000 }, 

new City { Name = "San Jose", Country = "US 
A", Population = 998537 }, 

new City { Name = "Paris", Country = "Franc 
e", Population = 2244000 } 


js 


public IEnumerable<City> Cities => cities; 


public void AddCity(City newCity) { 
cities.Add(newCity) ; 





ICityRepository 接 口 提 供 了 一 组 有 限 的 存储 库 
功能 ，MemoryCityRepository 类 使 用 List 来 实现 接 
Ele 


22.1.2 fi fe ill ZSF A 


HH Pk A mAai KEENE 
Controllers 文 件 夹 ， 将 一 个 名 为 HomeController.cs 的 
文件 添加 到 Controllers 文 件 夹 中 ， 并 用 它 定 义 代 码 
清单 22-5 所 示 的 类 。 





代码 清单 22-5 “Controllers 文 件 夹 下 的 HomeController.cs 文 件 的 


内 容 





using Microsoft.AspNetCore.Mvc; 
using UsingViewComponents.Models; 


namespace UsingViewComponents.Controllers { 


public class HomeController : Controller { 
private IProductRepository repository; 


public HomeController(IProductRepository repo) 


repository = repo; 


public ViewResult Index() => View(repository.Pr 
oducts); 


public ViewResult Create() => View(); 


[HttpPost | 
public IActionResult Create(Product newProduct) 


repository .AddProduct(newProduct) ; 
return RedirectToAction("Index") ; 





Home 控 制 器 使 用 构造 函数 来 声明 对 
IProductRepository 接 口 的 依赖 关系 ， 当 控制 器 用 于 
处 理 请 求 时 ，service provider 将 解析 该 接口 。Index 
操作 方法 从 存储 库 中 检索 所 有 Product 对 象 ， 并 使 用 
默认 视图 进行 泻 染 。 两 个 Create 方 法 使 用 的 是 
PosURedirectUGet 方 式 ， 用 客户 端 提 供 的 表单 数据 生 
成 新 的 对 象 并 添加 到 存储 库 中 。 





该 例 中 的 视图 将 共享 一 种 通用 布局 。 创 建 
Views/Shared 文 件 夹 ， 并 添加 一 个 名 为 


_Layout.cshtml 的 文件 ， 内 容 如 代码 清单 22-6 所 示 。 


代码 清单 22-6 Views/Shared 文 件 严 下 的 _Layout.cshtml 文 件 的 
内 容 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 
<title>@ViewBag.Title</title> 
<link asp-href-include="1lib/bootstrap/dist/css/*.mi 
n.css" rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
<div class="bg-primary m-1 p-1"> 
<div class="row text-white"> 
<div class="col-7"><h1>Products</h1></div> 
<div class="col-5"> 
<div class="bg-info text-center m-1 p-1 
">City Placeholder</div> 
</div> 
</div> 
</div> 
<div class="m-1 p-1">@RenderBody()</div> 
</body> 
</html> 





以 上 布局 定义 了 标题 ， 其 中 包含 一 个 占 位 符 ， 
用 于 显示 本 章 后 面 使 用 City 存 储 库 创建 的 内 容 。 创 





建 Views/Home 文 件 夹 ， 并 添加 一 个 名 为 
Index.cshtml 的 视图 文件 ， 内 容 如 代码 清单 22-7 所 
示 ， 其 中 列 出 了 表格 中 Product 对 象 的 详细 信息 。 


代码 清单 22-7 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 的 内 


IP 


谷 


@model IEnumerable<Product> 

@{ 
ViewData["Title"] = "Products"; 
Layout = "_Layout"; 


<table class="table table-sm table-striped table-border 
ed"> 
<thead> 
<tr><th>Name</th><th>Price</th></tr> 
</thead> 
<tbody> 
@foreach (var product in Model) { 
<tr> 
<td>@product .Name</td> 
<td>@product.Price</td> 
</tr> 


} 
</tbody> 
</table> 
<a asp-action="Create" class="btn btn-primary">Create</ 
a> 











Index 视 图 中 的 最 后 一 个 元 陛 伞 定义 为 按钮 ， 
且 链 接 指 同 Create 操 作 方 法 ， 用 来 在 存储 库 中 新 建 
一 个 Product 对 象 。 要 提供 用 户 填 写 的 表单 ， 可 在 
Views/Home 文 件 严 新 建 Create.cshtml 文 件 ， 并 还 加 
代码 清单 22-8 所 示 的 内 容 。 





代码 清单 22-8 ”Views/Home 文 件 夹 下 的 Create.cshtml 文 件 的 内 


IP 


谷 





@model Product 


@{ 
ViewData["Title"] = “Create Product"; 


Layout = "_Layout"; 


} 


<form method="post" asp-action="Create"> 
<div class="form-group"> 
<label asp-for="Name">Name:</label> 
<input class="form-control" asp-for="Name" /> 
</div> 
<div class="form-group"> 
<label asp-for="Price">Price:</label> 
<input class="form-control" asp-for="Price" /> 
</div> 
<button type="submit" class="btn btn-primary">Creat 
e</button> 
<a class="btn btn-secondary" asp-action="Index">Can 
cel</a> 


</form> 


这 些 视图 需要 使 用 内 置 的 标签 助手 ， 可 通过 在 
Views 文 件 夹 中 创建 _-ViewImports.cshtml 文 件 并 添 如 
代 人 码 清 单 22-9 所 示 的 表达 式 来 局 用 标签 助手 ， 这 可 
以 使 Models 文 件 夹 中 的 类 在 没有 命名 空间 的 情况 下 
也 可 用 。 














代码 清单 22-9” Views 文件 夹 下 的 _ViewImports.cshtml 文 件 的 内 


mL 
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@using UsingViewComponents.Models 

@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 
这 些 视图 还 依赖 于 Bootstrap CSS 包 来 提供 样 

式 。 这 里 使 用 Bower Configuration File 模 板 在 项 目 


的 根 目 录 中 创建 bower.json 文 件 ， 并 将 Bootstrap 添 
加 到 dependencies 部 分 ， 如 代码 清单 22-10 所 示 。 





代码 清单 22-10 在 UsingViewComponents 文 件 严 下 的 
bower.json X (4 F ¥stiBootstrap 


{ 


"name": "asp.net", 
"private": true, 


"dependencies": { 
"bootstrap": "4.0.0-alpha.6" 


} 
} 





22.1.3 配置 应 用 程序 


最 后 的 准备 步骤 是 配置 应 用 程序 ， 如 代码 清单 
22-11 所 示 。 除 了 配置 MVC 服 务 和 中 间 件 之 外 ， 还 
为 两 个 数据 存储 库 创 建 了 单 例 服务 。 


代码 清单 22-11 UsingViewComponents 文 件 夹 下 的 Startup.cs 文 


件 的 内 容 





using 
using 
using 
using 
using 
using 
using 
using 
using 


System; 

System.Collections.Generic; 

System. Linq; 

System. Threading.Tasks; 
Microsoft.AspNetCore. Builder; 
Microsoft.AspNetCore.Hosting; 
Microsoft.AspNetCore.Http; 

Microsoft. Extensions .DependencyInjection; 
UsingViewComponents.Models; 


namespace UsingViewComponents { 


public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<IProductRepository, M 
emoryProductRepository>(); 
services .AddSingleton<ICityRepository, Memo 
ryCityRepository>(); 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 








如 采 运 行 应 用 程序 ， 你 将 看 到 Product 存 储 库 中 
的 Product 对 象 列 表 。 可 以 通过 单 击 Create 投 钮 、 填 
写 表单 并 提交 到 服务 器 来 添加 新 的 商品 ， 添 加 完成 
ee 
Dy. FA Re Ae AS RI 1 SS a, AE ae 
会 显示 城市 数据 的 占 位 符 。 











D Products 





[D Products 


Name 


Kayak | 
| Stadium 
Lifejacket 


rr [) Create Product 
ée C O localhost X 
P d ul cts <€ CŒ ODO localhost ) | : 
: 
roducts 
| Products City Placeholder 
Name: 

Name Price 
Kayak 275 





图 22-1 运行 示例 应 用 程序 


22.2 ”视图 组 件 





应 用 程序 通 利 需要 在 视 岁 中 航 入 一 些 与 视图 主 
要 功能 无 关 的 内 容 。 第 见 的 示例 包括 网 站 导航 工 
有 具 、 以 及 让 用 户 不 用 访问 单独 的 页 面 束 能 登录 的 号 
份 验 证 面板 等 。 











所 有 这 些 示例 的 共同 线索 是 显示 钦 入 式 内 容 所 
需 的 数据 不 是 从 操作 传递 到 视图 的 模型 数据 的 一 部 
分 。 因 此 ， 这 里 在 示例 应 用 程序 中 创建 了 两 个 存储 
库 。 使 用 City 存 储 库 生成 的 一 些 内 容 ， 将 很 难 从 
Product 存 储 库 的 用 于 接收 数据 的 操作 中 获取 。 


第 21 章 描述 了 如 何 使 用 分 部 视图 来 创建 视 岁 中 
需要 的 可 重用 标记 ， 避 免 在 应 用 程序 的 多 个 位 置 复 
制 相同 的 内 容 。 分 部 视图 里 然 有 用 ， 但 它们 只 包含 
HIML 和 Razor 指 令 的 请 段 ， 并 且 操 作 的 数据 是 从 父 
视图 接收 的 。 如 采 需 要 显示 不 同 的 数据 ， 就 会 过 到 
问题 。 可 以 直接 从 分 部 视图 访问 需要 的 数据 ， 但 这 
会 破坏 文 持 MVC 模 式 的 关注 反 分 离 原 则 ， 并 导致 将 
数据 检索 和 处 理 迎 辑 放置 在 不 能 进行 单元 测试 的 视 
图 文件 中 。 也 可 以 扩展 应 用 程序 使 用 的 视图 模型 ， 
以 使 其 包含 所 需 的 数据 ， 但 这 意味 大 必须 更 改 每 个 
操作 方法 ， 并 使 对 操作 方法 的 测试 无 法 被 隔离 。 

















这 正 是 需要 使 用 视图 组 件 的 地 方 ， 视 图 组 件 是 
C# 类 ， 提 供 了 包含 所 圾 数据 的 分 部 视图 ， 独 立 于 父 
视图 和 操作 。 在 这 方面 ， 视 图 组 件 负 责 专 门 的 操 
作 ， 但 是 仅 用 于 提供 数据 的 分 部 视图 ， 不 能 接收 
HTTP 请 求 ， 并 且 提 供 的 内 容 将 始终 包 合 在 父 视图 











中 。 
22.3 创建 视图 组 件 


视图 组 件 可 以 通过 3 种 不 同 的 方式 创建 ， 分 别 
是 通过 定义 POCO 视 图 组 件 、 通 过 从 
ViewComponent 基 类 派生 以 及 使 用 ViewComponent 
特性 。 本 市 介绍 前 两 种 方式 ，22.4 市 将 介绍 第 三 种 


22.3.1 创建 POCO 视 图 组 件 





POCO 视图 组 件 是 一 种 不 依赖 于 任何 MVC API 
来 提供 视图 组 件 功能 的 类 。 与 POCO 控制 右 一 样 ， 
这 种 视图 组 件 非常 难以 使 用 ， 但 有 助 于 了 解 它们 的 
工作 原理 。POCO 视 图 组 件 是 任何 一 种 名 称 以 
ViewComponent 结 尾 并 定义 了 Invoke 方 法 的 类 。 视 
图 组 件 类 可 以 在 应 用 程序 中 的 任何 位 置 进行 定义 ， 





但 是 约定 将 它们 组 合 在 名 为 Components 的 文件 夹 
中 ， 该 文件 夹 位 于 项 目的 根 目录 下 。 创 建 这 个 文件 
夹 ， 并 添加 一 个 名 为 PocoViewComponent.cs 的 类 文 
件 ， 定 义 代码 清单 22-12 所 示 的 类 。 


代码 清单 22-12 Components XF% FH 
PocoViewComponent.cs 文 件 的 内 容 
using System.Ling; 
using UsingViewComponents .Models; 


namespace UsingViewComponents.ViewComponents { 


public class PocoViewComponent { 
private ICityRepository repository; 


public PocoViewComponent(ICityRepository repo) 


repository = repo; 


} 


public string Invoke() { 
return $"{repository.Cities.Count()} cities 
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+ $"{repository.Cities.Sum(c => c.Popul 
ation)} people"; 
} 


I 





视图 组 件 可 以 利用 依赖 注入 来 接收 所 需 的 服 
务 。 在 此 例 中 ，POCO 视 图 组 件 声明 了 对 
ICityRepository 接 口 的 从 属 关 系 ， 然 后 在 Invoke 方 法 
中 使 用 该 接口 来 创建 描述 城市 数量 和 人 口 总 数 的 字 
IFE o 





为 了 使 用 视图 组 件 ， 需 要 使 用 Razor @await 
Component.Invoke 表 达 式 。 可 通过 提供 类 的 名 称 
(不 包含 末尾 的 ViewComponent〉 作为 参数 来 选择 
视图 组 件 。 代 码 清单 22-13 已 经 删除 了 共享 布局 中 
的 占 位 符 ， 而 使 用 POCO 视图 组 件 取代 。 








代码 清单 22-13 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 使 用 视图 组 件 





<!DOCTYPE html> 
<html> 
<head> 


<meta name="viewport" content="width=device-width" 
/> 

<title>@ViewBag.Title</title> 

<link asp-href-include="1lib/bootstrap/dist/css/*.mi 
n.css" rel="stylesheet" /> 


</head> 
<body class="m-1 p-1"> 
<div class="bg-primary m-1 p-1"> 
<div class="row text-white"> 
<div class="col-7"><h1>Products</h1></div> 
<div class="col-5"> 
@await Component. InvokeAsync("Poco" ) 
</div> 
</div> 
</div> 
<div class="m-1 p-1">@RenderBody()</div> 
</body> 
</html> 








为 了 应 用 视图 组 件 ， 指 定 Poco 作 为 Invoke 方 法 
的 参数 。 当 视图 使 用 布局 时 ， 将 定位 
PocoViewComponent 类 ， 调 用 Invoke 方 法 ， 并 将 结 
果 插 入 父 视图 的 输出 ， 如 图 22-2 所 示 。 











图 22-2 ”使 用 简单 的 视图 组 件 





这 只 是 一 个 简单 的 例子 ， 但 它 说 明了 视图 组 件 

的 一 些 重要 特性 。 首 先 ，PocoViewComponent 类 能 
够 访问 所 需 的 数据 ， 而 不 依赖 于 处 理 HTTP 请 求 或 

父 视 图 的 操作 。 其 次 ， 在 C# 类 中 定义 获取 和 处 理 城 
市 信息 所 需 的 逻辑 意味 着 可 以 轻松 进行 单元 测试 
《参见 22.3.4 节 ) . Ba, MARR ATR, W 
图 在 关注 Product 对 象 的 视图 模型 中 包含 City 对 和 象 。 


1 


Fai aot 
El 





在 视图 中 应 用 视图 组 件 时 ， 必 须 包 含 await 关 键 
字 。 如 果 只 调用 @Component.Invoke， 虽 然 不 会 报 
着 ， 但 只 会 显示 任务 的 字符 串 表 示 形 式 ， 类 似 于 





System.Threading.Tasks.Task 1 


[Microsoft.AspNetCore.Html.IHtmlContentj] 。 


22.3.2 ”从 ViewComponent 基 类 派生 


POCO 视 图 组 件 的 功能 有 限 ， 除 非 它 们 可 以 利 
用 MVC API， 这 就 需要 执行 一 些 更 多 的 操作 ， 需 要 
从 ViewComponent 基 类 派生 。 
Microsoft.AspNetCore.Mvc 命 名 空间 中 定义 的 
ViewComponent 类 可 以 方便 地 访问 上 下 文 数据 ， 从 
而 更 容易 生成 结果 。 代 码 清 单 22-14 显 示 了 添加 到 
Components 文 件 夹 下 的 CitySummary.cs 文 件 的 内 
容 。 





代码 清单 22-14 Components 文 件 夹 下 的 CitySummary.cs 文 件 的 
内 容 





using System.Ling; 
using Microsoft.AspNetCore.Mvc; 
using UsingViewComponents .Models; 


namespace UsingViewComponents.Components { 


public class CitySummary : ViewComponent { 
private ICityRepository repository; 


public CitySummary(ICityRepository repo) { 
repository = repo; 
} 


public string Invoke() { 
return $"{repository.Cities.Count()} cities 
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+ $"{repository.Cities.Sum(c => c.Populatio 
n)} people"; 
} 


} 





在 从 基 关 派生 时 ， 不 需要 在 类 名 中 包含 
ViewComponent。 除 了 使 用 基 类 之 外 ，POCO 视 图 
组 件 与 POCO 功 能 相同 。 下 面 将 展示 如 何 使 用 基 类 
提供 的 便利 功能 来 实现 不 同 的 视图 组 件 功 能 。 





二 


提 ” 示 


注意 ， 代 码 清 单 22-14 没 有 重 写 Invoke 方 法 。 
ViewComponent 类 不 提供 Invoke 方 法 的 默认 实现 ， 
因而 必须 明确 定义 。 














为 了 演示 视图 组 件 的 特性 ， 更 改 共 享 布局 中 使 
用 的 组 件 ， 如 代码 清单 22-15 所 示 ， 使 用 nameof 而 
不 是 直接 用 字符 串 指定 视图 组 件 的 名 称 ， 第 4 章 介 
绍 过 ， 这 样 可 以 减少 类 名 错误 的 可 能 性 。 








代码 清单 22-15 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 修改 视图 组 件 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 
<title>@ViewBag.Title</title> 
<link asp-href-include="1lib/bootstrap/dist/css/*.mi 


n.css" rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
<div class="bg-primary m-1 p-1"> 
<div class="row text-white"> 
<div class="col-7"><h1>Products</h1></div> 
<div class="col-5"> 
@await Component. InvokeAsync(nameof (Cit 


ySummary) ) 
</div> 
</div> 
</div> 


<div class="m-1 p-1">@RenderBody()</div> 
</body> 
</html> 





修改 视图 导入 文件 ， 从 而 可 以 在 没有 命名 空间 
的 nameof 表 达 式 中 引用 CitySummary 类 ， 如 代码 清 
单 22-16 所 示 。 


代码 清单 22-16 ”在 Views 文 件 夹 下 的 _ViewImports.cshtml 文 件 
中 添加 命名 空间 


@using UsingViewComponents.Models 
@using UsingViewComponents.Components 





@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 


22.3.3 ”视图 组 件 结果 


将 简单 的 字符 串 值 插入 父 视 图 的 功能 并 不 是 特 
列 有 用， 但 鞋 运 的 是 ， 视 图 组 件 能 够 做 更 多 。 通 过 
使 Invoke 方 法 返回 实现 了 IViewComponentResult 接 
口 的 对 象 ， 可 以 实现 更 复杂 的 效果 。3 个 内 置 的 类 
实现 了 IViewComponentResult 接 口 ， 如 表 22-3 所 
示 ，ViewComponent 基 类 提供 了 创建 它们 的 便利 方 
法 。 接 下 来 介绍 每 种 结果 类 型 的 用 法 。 





YO 

注 意 

如 果 使 用 POCO 视 图 组 件 ， 束 可 以 直接 创建 这 
些 类 的 实例 ， 尽 管 它们 可 能 很 难处 理 ， 因 为 它们 都 


有 具有 很 复杂 的 构造 图 数 。ViewComponent 关 则 提供 
了 创建 它们 的 简便 方法 。 





表 22-3 内置 的 [ViewComponentResult 实 现 类 
































用 于 指定 Razor 视 图 ， 并 且 有 具有 可 选 的 视图 模型 数据 。 
该 类 的 实例 可 使 用 View 方 法 创建 























ViewViewComponentResult 

















用 于 指定 包含 在 HTML 文 档 中 且 被 安全 编码 的 文本 结 
果 。 该 类 的 实例 可 使 用 Content 方 法 创建 











ContentViewComponentResult 























用 于 指定 包含 在 HTML 文 档 中 的 HTML 片 段 ， 无 须 进 一 
HtmlContentViewComponentResult | 步 编 码 。 没 有 可 用 于 创建 这 种 类 型 结果 的 























ViewComponent 方 法 








有 两 种 结果 类 型 需要 做 特殊 处 理 。 如 采 视 图 组 
件 返 回 一 个 字符 串 ， 那 么 它 用 于 创建 
ContentViewComponentResult 对 象 。 如 果 视 图 组 件 
返回 IHtmlContent 对 象 ， 那 么 它 用 于 创建 
HtmlContentViewComponentResult 对 象 。 





最 党 使 用 的 啊 应 为 ViewViewComponentResult 
对 象 ， 它 告诉 Razor 呈 现 局 部 视图 ， 并 将 结果 包含 
在 父 视图 中 。ViewComponent 基 类 提供 了 用 于 创建 
ViewViewComponentResult 对 象 的 View 方 法 ， 并 是 
有 4 个 版 本 的 View 方 法 可 用 ， 如 表 22-4 所 示 。 











表 22-4 ViewComponent.View 方 法 





pmo pan yaragan 














选择 默认 视图 并 使 用 指定 的 对 象 作为 视图 模型 
































和 ee oaase nen 
选择 指定 的 视图 并 使 用 指定 的 对 象 作 为 视图 模型 


这 些 View 方 法 对 应 于 由 Controller 基 类 提供 的 
方法 ， 并 且 以 相同 的 方式 使 用 。 在 Models 文 件 夹 中 
添加 一 个 名 为 CityViewModel.cs 的 类 文件 ， 用 来 定 




















义 视 图 模型 ， 如 代码 清单 22-17 所 示 。 


代码 清单 22-17 Models 文 件 夹 下 的 CityViewModel.cs 文 件 的 内 


mL 


4S 


namespace UsingViewComponents.Models { 


public class CityViewModel { 
public int Cities { get; set; } 
public int Population { get; set; } 





代码 清单 22-18 修 改 了 CitySummary 视 图 组 件 的 
Invoke 方 法 ， 以 便 能 够 使 用 View 方 法 来 选择 分 部 视 
图 ， 并 使 用 CityViewModel 对 象 提供 视图 数据 。 





代码 清单 22-18 在 Controller 文 件 夹 下 的 CitySummary.cs 文 件 中 
选择 分 部 视图 





using System.Ling; 

using Microsoft.AspNetCore.Mvc; 

using UsingViewComponents .Models ; 
namespace UsingViewComponents.Components { 


public class CitySummary : ViewComponent { 
private ICityRepository repository; 


public CitySummary(ICityRepository repo) { 
repository = repo; 
} 


public IViewComponentResult Invoke() { 
return View(new CityViewModel{ 
Cities = repository.Cities.Count(), 
Population = repository.Cities.Sum(c => 
c.Population) 


}); 








FEA ZA AEP EET ER EE hill a AP gE 
视图 类 似 ， 但 有 两 个 重要 区 别 : Razor 在 不 同位 置 
伍 找 视图 ， 并 且 如 末 未 指定 视图 ， 束 使 用 不 同 的 默 
WAR A KERALA « 




















因为 没有 为 视图 组 件 创建 分 部 视图 ， 所 以 在 运 
行 显示 Razor 所 要 查找 的 文件 的 应 用 程序 时 ， 你 将 
会 看 到 一 条 错误 消 县 








如 果 没 有 指定 名 称 ， 那 么 Razor 会 尝试 寻找 名 





为 Default.cshtml 的 文件 。Razor 会 在 两 个 位 置 
(/Views 
/Home/Components/CitySummary/Default.cshtml 
/Views/Shared/Components/CitySummary/Default.cs 
查找 分 部 视图 。 第 一 个 位 置 考虑 了 处 理 HTTP 请 求 
的 控制 右 的 名 称 ， 以 允许 每 个 控制 占 拥 有 自己 的 目 
定义 视图 ， 第 二 个 位 置 可 在 所 有 控制 二 之 间 共 宇 。 


人 
提 示 


请 注意 ， 共 宇 的 分 部 视图 仍然 由 视图 组 件 区 
分 ， 这 意味 着 视图 组 件 不 能 共 至 分 部 视图 。 可 以 通 
过 在 调用 View 方 法 时 ， 在 视图 名 称 中 包含 路 径 来 履 
兰 这 种 行为 ， 比 如 调用 








View ("Views/Shared/Components/Common/Default. 


html” ) 将 禾 再 分 部 视图 的 默认 搜索 位 置 。 


为 完成 此 例 ， 创 建 
Views/Home/Components/CitySummary 文 件 夹 ， 并 
添加 一 个 名 为 Default.cshtml 的 视图 文件 ， 内 容 如 代 
码 清 单 22-19 所 示 。 


代码 清单 22-19 Views/Home/Components/CitySummary 文 件 夹 
下 的 Default.cshtml 文 件 的 内 容 





@model CityViewModel 


<table class="table table-sm table-bordered"> 
<tr> 
<td>Cities:</td> 
<td class="text-right"> 
@Model.Cities 
</td> 
</tr> 
<tr> 
<td>Population:</td> 
<td class="text-right"> 
@Model.Population.ToString("#, ###" ) 


</td> 
</tr> 
</table> 


ANN, ERAF AI o> RBAN -5 FE il) at AY VE 77 AH 
同 。 在 这 种 情况 下 ， 创 建 一 个 强 类 型 的 视图 ， 它 可 
以 包含 一 个 CityViewModel 对 象 ， 并 在 表格 中 显示 
Cities 和 Population 值 ， 如 图 22-3 所 示 。 
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图 22-3 ”使 用 视图 组 件 演 染 视图 
2. 返回 HTML 片段 


ContentViewComponentResult 类 可 以 在 不 使 用 
视图 的 情况 下 ， 在 父 视图 中 包含 HTML 片段 。 
ContentViewComponentResult 类 的 实例 可 使 用 继承 


和 目 ViewComponent 基 类 的 Content 方 法 创建 ， 该 方法 
接收 字符 串 值 。 代 码 清 单 22-20 演 示 了 如 何 使 用 
Content 方 法 。 除 了 Content 方 法 之 外 ，Invoke 方 法 可 
以 返回 一 个 字符 串 ，MVC 将 自动 把 它 转换 为 


ContentViewComponentResult 对 象 。 





代码 清单 22-20 ”在 Components 文 件 夹 下 的 CitySummary.cs 文 件 
中 使 用 Content 方 法 


using System.Ling; 
using Microsoft.AspNetCore.Mvc; 
using UsingViewComponents .Models ; 


namespace UsingViewComponents.Components { 


public class CitySummary : ViewComponent { 
private ICityRepository repository; 
public CitySummary(ICityRepository repo) { 


repository = repo; 


} 


public IViewComponentResult Invoke() { 
return Content("This is a <h3><i>string</i> 
</h3>"); 
} 
} 





对 Content 方 法 接收 到 的 字符 串 进行 编码 ， 使 其 
安全 地 包含 在 HIML 文 档 中 。 当 处 理由 用 户 或 外 部 
系统 提供 的 内 容 时 ， 这 特别 重要 ， 因 为 可 以 阻止 
JavaScript 内 容 被 巷 入 应 用 程序 生成 的 HIML 中 。 在 
此 例 中 ， 传 递 给 Content 方 法 的 字符 串 包 含 一 些 基 本 
的 HTML 标 签 ， 如 果 运 行 应 用 程序 ， 你 将 看 到 它们 
己 被 安全 地 编码 ， 如 图 22-4 所 示 。 
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图 22-4 ”使 用 视图 组 件 返回 编码 的 HTML 片 段 
如 宁 碍 看 视图 组 件 生 成 的 HIML， 你 会 发 现 尖 
FES OP, MEDI bias AES A AE AT ML 
元 素 ， 如 下 所 示 : 








<div class="col-5">This is a &lt;h3><i>string&lt;/i></h 


3></div> 
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不 需要 对 内 容 进 行 编码 。Content 方 法 总 是 对 参数 进 
行 编码 ， 因 此 必须 直接 创建 
HtmlContentViewComponentResult 对 象 ， 并 为 其 构 
造 函 数 提供 一 个 HtmlSstring 对 象 ， 该 对 象 会 显示 你 
认为 可 以 安全 显示 的 字符 如， 因为 来 源 值得 信任 ， 
或 者 因为 你 确信 和 它们 已 经 编码 ， 如 代码 清单 22-21 
所 示 。 


代码 清单 22-21 在 Components 文 件 夹 下 的 CitySummary.cs 文 件 
中 返回 信任 的 HTML 片段 





using System.Ling; 

using Microsoft.AspNetCore.Mvc; 

using UsingViewComponents .Models ; 

using Microsoft.AspNetCore.Mvc.ViewComponents ; 
using Microsoft.AspNetCore.Html; 


namespace UsingViewComponents.Components { 


public class CitySummary : ViewComponent { 


private ICityRepository repository; 


public CitySummary(ICityRepository repo) { 
repository = repo; 
F 


public IViewComponentResult Invoke() { 
return new HtmlContentViewComponentResult( 
new HtmlString("This is a <h3><i>string 
</i></h3>")); 
} 


} 





以 上 方法 应 慎 用 ， 只 有 当 使 用 不 能 算 改 的 内 容 
来 源 ， 并 执行 自己 的 编码 时 才 可 使 用 。 如 果 运 行 应 
用 程序 ， 你 将 看 到 人 尖 插 号 已 包含 在 父 视图 中 而 未 修 
改 ， 这 人 允许 浏览 器 将 视图 组 件 的 输出 解释 为 HTML 
元 素 ， 如 图 22-5 所 示 。 


Thisisa 


string 
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22.3.4 获取 上 下 文 数 据 


有 关 当 前 请 求 和 父 视图 的 详细 信息 会 通过 
ViewComponentContext 类 的 属性 提供 给 视图 组 件 ， 
表 22-5 描 述 了 该 类 提供 的 一 些 有 用 的 属性 。 


表 22-5 ViewComponentContext 类 定义 的 属性 
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i [=] 4 ViewComponentDescriptor®t #, VWiPEHEAL AZAR 
ViewComponentDescriptor | 、 


eects 
返回 一 个 ViewDataDictionary 对 象 ， 以 提供 对 视图 组 件 的 视图 类 
ViewData a 
的 访问 


ViewComponent 基 类 提供 了 一 组 便于 访问 特定 















































上 下 文 信息 的 属性 ， 如 表 22-6 所 示 。 


表 22-6 ViewComponent 基 类 定义 的 属性 









































i 苗 述 当前 请 求 和 正在 准备 的 响应 的 HttpContext 对 象 
i 昔 述 当前 HTTP 请 求 的 HttpRequest 对 象 

i 苗 述 当前 用 户 的 IPrincipal 对 和 象 

i HS REOR AY ER EH AH A RouteData xt Fe 




























































































ViewBag 


—~SModelStateDictionaryx} KR, LAPEER AALS ce REN HEA 
ModelState 


返回 一 个 ViewDataDictionary 对 象 ， 以 提供 对 视图 组 件 的 视图 数据 
ViewData 7 
的 访问 
























































Url 返回 一 个 可 用 于 生成 URL 的 IUrlHelper 对 象 








上 下 文 数据 可 以 各 种 方式 用 于 帮助 视图 组 件 执 
行 工 作 ， 包 括 改变 数据 的 选择 方式 以 及 呈现 不 同 的 
内 容 或 视图 。 代 码 清单 22-22 使 用 路 由 数据 来 缩小 
City 对 象 的 选择 范围 。 





代码 清单 22-22 ”在 Components 文 件 夹 下 的 CitySummary.cs 文 件 
中 使 用 上 下 文 数据 





using System.Ling; 

using Microsoft.AspNetCore.Mvc; 

using UsingViewComponents .Models; 

using Microsoft.AspNetCore.Mvc.ViewComponents ; 
using Microsoft.AspNetCore.Mvc.Rendering; 


namespace UsingViewComponents.Components { 


public class CitySummary : ViewComponent { 
private ICityRepository repository; 


public CitySummary(ICityRepository repo) { 
repository = repo; 


} 


public IViewComponentResult Invoke() { 
string target = RouteData.Values["id"] as s 
tring; 


var cities = repository.Cities 
.Where(city => target == null || 
string.Compare(city.Country, target 


» true) == @); 
return View(new CityViewModel{ 
Cities = cities.Count(), 
Population = cities.Sum(c => c.Populati 





浏览 器 使 用 路 由 中 的 id 片 段 来 指定 国家 数据 ， 
使 用 LINQ 来 过 小 存储 库 中 的 对 象 。 如 果 局 动 应 用 
程序 并 请 求 默认 UREL， 就 会 显示 所 有 城市 。 可 以 通 
过 请 求 URL (比如 /Home/Index/USA) 来 缩小 选择 
苑 围 ， 这 样 可 以 将 选择 范围 缩 小 到 美国 的 城市 ， 如 
图 22-6 所 示 。 











图 22-6 ”在 视图 组 件 中 使 用 上 下 文 数据 
使 用 参数 从 父 视图 提供 上 下 文 


父 视图 可 以 提供 附加 的 上 下 文 数据 作为 @await 
Component.Invoke 表 达 式 的 参数 。 此 功能 可 用 于 从 
父 视图 模型 提供 数据 ， 或 指导 视图 组 件 生成 有 关 类 
型 的 内 容 。 为 了 演示 此 功能 ， 在 
Views/Home/Component/ CitySummary 文 件 夹 中 创 

建 一 个 名 为 CityList.cshtml 的 视图 文件 ， 内 容 如 代码 
清单 22-23 所 示 。 














代码 清单 22-23 Views/Home/Component/City Summary X4} 3 
下 的 CityList.cshtml 文 件 的 内 容 





@model IEnumerable<City> 


<table class="table table-sm table-bordered"> 
@foreach (var city in Model) { 
<tr> 
<td>@city.Name</td> 
<td class="text-right"> 
@city.Population.ToString("#, ###" ) 
</td> 


</tr> 


} 
<tr> 
<th>Total:</th> 
<td class="text-right"> 
@Model.Sum(p => p.Population).ToString("#,# 
HH") 
</td> 
</tr> 
</table> 








添加 第 二 个 视图 以 允许 在 视图 之 则 选择 视图 组 
件 ， 根 据 添加 到 Invoke 方 法 的 参数 完成 该 操作 ， 如 
代码 清单 22-24 所 示 。 


代码 清单 22-24 ”在 Components 文 件 夹 下 的 CitySummary.cs 文 件 
中 选择 视图 





using System.Ling; 

using Microsoft.AspNetCore.Mvc; 

using UsingViewComponents .Models; 

using Microsoft.AspNetCore.Mvc.ViewComponents ; 
using Microsoft.AspNetCore.Mvc.Rendering; 


namespace UsingViewComponents.Components { 


public class CitySummary : ViewComponent { 
private ICityRepository repository; 


public CitySummary(ICityRepository repo) { 


repository = repo; 
public IViewComponentResult Invoke(bool showLis 


if (showList) { 
return View("CityList", repository.Citi 


} else { 
return View(new CityViewModel { 
Cities = repository.Cities.Count(), 
Population = repository.Cities.Sum( 


c => c.Population) 


}); 





如 果 Invoke 方 法 的 showList 参 数 为 tue， 视 图 组 
件 就 选择 CityList， 并 将 存储 库 中 的 所 有 City 对 象 作 
为 视图 模型 传递 。 如 果 showList 参 数 为 false， 就 选 
择 默 认 视 图 ， 并 为 视图 模型 提供 一 个 CitysSummary 
对 象 。 





最 后 一 步 古 在 父 视图 中 应 用 视图 组 件 时 提供 上 
下 文 数据 ， 方 法 是 将 匿名 对 象 传递 给 Invoke 方 法 ， 





如 代码 清单 22-25 所 示 。 


代码 清单 22-25 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 提供 上 下 文 数 据 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 


<title>@ViewBag.Title</title> 

<link asp-href-include="1lib/bootstrap/dist/css/*.mi 
n.css" rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 

<div class="bg-primary m-1 p-1"> 


<div class="row text-white"> 
<div class="col-7"><h1>Products</h1></div> 
<div class="col-5"> 
@await Component. InvokeAsync("CitySumma 
ry", new { showList = true }) 
</div> 
</div> 
</div> 
<div class="m-1 p-1">@RenderBody()</div> 
</body> 
</html> 





如 果 运 行 应 用 程序 ， 视 图 组 件 将 接收 父 视图 指 
定 的 值 ， 并 相应 地 进行 啊 应 ， 结 果 如 图 22-7 所 示 。 


€ > CS |O locaihost:s9709 úl i 
London 38,539,000 | 








图 22-7 向 视图 组 件 提供 上 下 文 数据 


测试 视图 组 件 


视图 组 件 遵 循 一 般 的 MVC 方 法 ， 从 格式 化 和 
呈现 模型 数据 的 视图 标记 中 分 离 出 选择 模型 数据 并 
进行 处 理 的 逻辑 ， 从 而 可 以 轻松 地 执行 单元 测试 。 
以 下 是 示例 应 用 程序 中 用 于 CitySummary 的 单元 测 
试 : 





using System.Collections.Generic; 
using Microsoft.AspNetCore.Mvc.ViewComponents; 
using Mog; 


using UsingViewComponents .Models ; 
using UsingViewComponents .Components ; 
using Xunit; 


namespace UsingViewComponents.Tests { 
public class SummaryViewComponentTests { 


[Fact] 
public void TestSummary() { 


// Arrange 
var mockRepository = new Mock<ICityReposito 
ry>(); 
mockRepository.SetupGet(m => m.Cities).Retu 
rns(new List<City> { 
new City { Population = 100 }, 
new City { Population = 20000 }, 
new City { Population = 1000000 }, 
new City { Population = 500000 } 
})3 
var viewComponent 
= new CitySummary(mockRepository.Object 


); 


// Act 
ViewViewComponentResult result 
= viewComponent.Invoke(false) as ViewVi 
ewComponentResult; 


// Assert 
Assert. IsType(typeof (CityViewModel), result 
.ViewData.Model1) ; 
Assert.Equal(4, ((CityViewModel)result.View 
Data.Model).Cities) ; 
Assert. Equal(1520100, 
((CityViewModel)result.ViewData.Model). 


Population) ; 


} 
} 


为 了 安排 测试 ， 创 建 假 的 存储 库 并 传递 给 
CitySummary 类 的 构造 函数 ， 以 创建 视图 组 件 的 新 
实例 。 对 于 测试 的 act 部 分 ， 调 用 Invoke 方 法 以 提供 
结果 对 象 。 视 图 组 件 选择 了 Razor 钢 图 ， 因 此 将 结 
末 转 换 为 ViewViewComponentResult， 并 通过 提供 
的 ViewData.Model 属 性 访问 视图 模型 对 象 。 对 于 测 
试 的 Assert 部 分 ， 检 枉 视图 模型 数据 的 类 型 及 其 包 
AE 





22.3.5 ”创建 异步 视图 组 件 


本 章 运 今 为 止 的 所 有 示例 使 用 的 都 是 同步 视图 
组 件 ， 可 以 识别 它们 ， 因 为 它们 定义 了 Invoke 方 





法 。 如 果 视 图 组 件 依赖 于 异步 API， 则 可 以 通过 定 
义 返 回 任 务 的 InvokeAsync 方 法 来 创建 异步 视图 组 
件 。 当 Razor 从 InvokeAsync 方 法 接收 到 任务 时 ， 将 
等 竺 任务 完成 ， 然 后 将 结果 插入 主 视 图 。 为 了 准备 
此 例 ， 在 Solution Explorer ti t F A tE 
UsingViewComponents 项 目 ， 在 弹出 的 来 单 中 选择 
Edit UsingViewComponents.csproj， 并 进行 代码 清单 
22-26 所 示 的 更 改 ， 以 同 项 目 添加 包 。 





代码 清单 22-26 ”在 UsingViewComponents.csproj 文 件 中 添加 包 





<Project Sdk="Microsoft.NET.Sdk.Web"> 


<PropertyGroup> 
<TargetFramework>netcoreapp2.0</TargetFramework> 
</PropertyGroup> 


<ItemGroup> 
<Folder Include="wwwroot\" /> 
</ItemGroup> 


<ItemGroup> 
<PackageReference Include="Microsoft.AspNetCore.All 
" Version="2.0.0 " /> 
<PackageReference Include="System.Net.Http" Version 
="4.3.2" /> 


</ItemGroup> 


</Project> 





System.Net.Http 包 提供 了 一 个 用 于 进行 异步 
HTTP 请 求 的 API， 这 里 将 用 它 伍 询 Apress 网 站 。 代 
人 码 清 单 22-27 显 示 了 名 为 PageSize.cs 的 类 文件 的 内 
窑 ， 将 这 个 类 文件 添加 到 Components 文 件 夹 中 ， 用 
于 创建 异步 视图 组 件 。 





代码 清单 22-27 Components 文 件 夹 下 的 PageSize.cs 文 件 的 内 


IP 


谷 





using System.Net.Http; 
using System. Threading. Tasks; 
using Microsoft.AspNetCore.Mvc; 


namespace UsingViewComponents.Components { 
public class PageSize : ViewComponent { 


public async Task<IViewComponentResult> InvokeA 
sync() { 
HttpClient client = new HttpClient(); 
HttpResponseMessage response 
= await client.GetAsync("http://apress. 
com"); 
return View(response.Content.Headers.Conten 


tLength) ; 
} 
} 
} 

InvokeAsync 方 法 通过 第 4 章 摘 述 的 async 和 
await 关 键 字 来 使 用 HttpClient 类 提供 的 异步 API， 并 
通过 回 Apress.com 发 送 GET 请 求 来 获取 所 返回 内 容 
的 长 度 。 将 长 度 传递 给 View 方 法 ， 选 择 与 视图 组 件 
关联 的 默认 分 部 视图 。 





为 了 创建 视图 ， 在 项 目 中 添加 
Views/Shared/Components/PageSize 文 件 夹 ， 并 在 其 
中 添加 一 个 名 为 Default.cshtml 的 视图 文件 ， 内 容 如 
代码 清单 22-28 所 示 。 





代码 清单 22-28 Views/Shared/Components/PageSize 文 件 夹 下 
的 Default.cshtml 文 件 的 内 容 


@model long 


<div class="m-1 p-1 bg-info text-white">Page size: @Mod 
el</div> 





最 后 一 步 是 在 _Layout.cshtml 文 件 中 使 用 异步 视 
图 组 件 ， 如 代码 清单 22-29 所 示 。 


代码 清单 22-29 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 使 用 异步 视图 组 件 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>@ViewBag.Title</title> 
<link asp-href-include="1ib/bootstrap/dist/css/*.mi 
n.css" rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
<div class="bg-primary m-1 p-1"> 
<div class="row text-white"> 
<div class="col-7"><h1>Products</h1></div> 
<div class="col-5"> 
@await Component. InvokeAsync("CitySumma 


new { showList = true }) 


</div> 
</div> 
</div> 
<div class="m-1 p-1">@RenderBody()</div> 
@await Component. InvokeAsync("PageSize" ) 
</body> 
</html> 





如 有 果 局 动 应 用 程序 ， 你 将 在 浏览 器 中 看 到 新 增 
的 内 容 ， 如 图 22-8 所 示 。 当 运行 示例 时 ， 显 示 的 数 
字 可 能 会 更 改 ， 因 为 Apress 经 常 更 新 其 网 站 。 


Soccer ball 





图 22-8 创建 异步 视图 组 件 
22.4 创建 混合 的 控制 局/ 视图 组 件 类 


视图 组 件 通常 提供 由 控制 堪 深 入 处 理 的 功能 的 
摘要 或 快照 。 例 如 ， 对 于 购物 车 视图 组 件 ， 通 党 会 
存在 一 个 链接 ， 目 标 是 一 个 控制 各 ， 该 控制 占 近 供 
购物 车 中 商品 的 详细 列表 ， 并 且 可 以 用 于 蜂 选 并 完 
成 购买 。 





在 这 种 情况 下 ， 可 以 创建 混合 的 控制 右 / 视 图 
组 件 类 ， 这 样 可 以 将 相关 功能 组 合 在 一 起 并 减少 代 





码 重 复 。 为 了 演示 ， 将 一 个 名 为 CityController.cs 的 
类 文件 添加 到 Controllers 文 件 夹 中， 并 用 它 定 义 代 
人 码 清 单 22-30 所 示 的 控制 器 。 





代码 清单 22-30 ”Controllers 文 件 夹 下 的 CityController.cs 文 件 的 
内 容 





using System.Collections.Generic; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.ViewComponents ; 
using Microsoft.AspNetCore.Mvc.ViewFeatures; 
using UsingViewComponents.Models; 


namespace UsingViewComponents.Controllers { 


[ViewComponent(Name = "ComboComponent") ] 
public class CityController : Controller { 
private ICityRepository repository; 


public CityController(ICityRepository repo) { 
repository = repo; 

} 

public ViewResult Create() => View(); 


[HttpPost ] 

public IActionResult Create(City newCity) { 
repository .AddCity(newCity) ; 
return RedirectToAction("Index", "Home") ; 


public IViewComponentResult Invoke() => new Vie 
wViewComponentResult() { 
ViewData = new ViewDataDictionary<IEnumerab 
le<City>>(ViewData, 
repository.Cities) 





将 ViewComponent 特 性 应 用 于 不 从 
ViewComponent 基 类 继承 且 名 称 不 以 
ViewComponent 结 尾 的 类 ， 这 意味 着 正常 的 发 现 过 
程 通 第 不 会 将 类 看 作 视 网 组 件 。Name 属 性 用 于 设 
置 在 父 视图 中 使 用 @Component.Invoke 表 达 式 应 用 
类 时 可 以 引用 类 的 名 称 。 在 此 例 中 ， 使 用 Name 属 
性 将 类 的 视图 组 件 部 分 的 名 称 设 置 成 
ComboComponent。 访 名 称 将 用 于 调用 视图 组 件 并 
ARME. 











为 混合 类 不 能 从 ViewComponent 基 类 继承 ， 
所 以 它们 无 法 访问 IViewComponentResult 对 象 提 供 
的 便利 方法 ， 这 意味 看 必须 直接 创建 


ViewViewComponentResult 对 象 ， 就 像 POCO 视图 组 
件 中 所 需要 的 那样 。 





22.4.1 创建 混合 视图 





混合 类 需要 两 组 视图 一 一 当 类 用 作 控 制 占 时 渔 
染 的 视图 以 及 在 将 类 用 作 视 图 组 件 时 呈现 的 视图 。 
首先 ， 创 建 Views/City 文 件 诡 ， 并 添加 一 个 名 为 
Create.cshtml 的 视图 文件 ， 内 容 如 代码 清单 22-31 所 
ZN o 


代码 清单 22-31 Views/City 文 件 夹 下 的 Create.cshtml 文 件 的 内 


IP 


谷 





@model City 
@{ 


ViewData["Title"] = "Create City"; 
Layout = "_Layout"; 
} 


<form method="post" asp-action="Create"> 
<div class="form-group"> 
<label asp-for="Name">Name:</label> 
<input class="form-control" asp-for="Name" /> 
</div> 


<div class="form-group"> 
<label asp-for="Country">Country:</label> 
<input class="form-control" asp-for="Country" / 


</div> 
<div class="form-group"> 
<label asp-for="Population">Population:</label> 
<input class="form-control" asp-for="Population 
" /> 
</div> 
<button type="submit" class="btn btn-primary">Creat 
e</button> 
<a class="btn btn-secondary" asp-controller="Home" 
asp-action="Index"> 
Cancel 


</a> 
</form> 








Create 视 图 提供 了 一 个 简单 的 用 于 创建 City 对 
RAN AH. CreatefZ# In] City #2 iil] 4s HY Create te /F 
方法 发 送 POST 请 求 ， 而 Cancel 按 钮 会 回 Home 控 制 
Air HJ Index tR F 77 1& RIK GET WK 


接 下 来 ， 创 建 
Views/Shared/Components/ComboComponent X {F 
夹 ， 并 添加 一 个 名 为 Default.cshtml 的 视图 文件 ， 内 


容 如 代码 清单 22-32 所 示 。 将 分 部 视图 放置 在 
Views/Shared 文 件 夹 中 ， 视 图 组 件 的 名 称 将 包含 在 
用 于 定位 视图 的 路 径 中 。 








代码 清单 22-32 Views/Shared/Components/ComboComponent 
文件 夹 下 的 Default.cshtml 文 件 的 内 容 


@model IEnumerable<City> 


<table class="table table-sm table-bordered"> 
<tr> 
<td>Biggest City:</td> 
<td> 
@Model.OrderByDescending(c => c.Population) 
.First().Name 
</td> 
</tr> 
</table> 
<a class="btn btn-sm btn-info" asp-controller="City" as 
p-action="Create"> 
Create City 





这 个 分 部 视图 接收 使 用 LINQ 排 序 的 City 对 象 序 
列 ， 以 选择 具有 最 大 Population 值 的 那个 。 还 有 一 
个 可 设置 样式 为 按钮 的 销 点 元 素 ， 按 钮 将 指 问 City 


控制 器 的 Create 操 作 方 法 。 


G 


je ” 示 





代码 清单 22-32 明 确 指 定 了 用 于 a 元 素 的 City 控 
制 费 。 可 使 用 父 视图 提供 的 上 下 文 数据 生成 URL， 
这 意味 着 默认 控制 右 就 是 处 理 请 求 的 控制 器 ， 而 不 
是 使 用 视图 组 件 的 控制 器 。 如 果 省 略 asp-controller 
属性 ， 链 接 将 在 Home 控 制 器 上 定位 Create 操 作 方 
oe 








22.4.2 ”应 用 混合 类 








最 后 一 步 是 使 用 ViewComponent 特 性 指定 的 名 
称 将 混合 类 作为 视图 组 件 应 用 于 共享 布局 ， 如 代码 
清单 22-33 所 示 。 











代码 清单 22-33 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 应 用 混合 A RB 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>@ViewBag.Title</title> 
<link asp-href-include="1lib/bootstrap/dist/css/*.mi 
n.css" rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
<div class="bg-primary m-1 p-1"> 
<div class="row text-white"> 
<div class="col-7"><h1>Products</h1></div> 
<div class="col-5"> 
@await Component. InvokeAsync("ComboComp 


onent" ) 


</div> 
</div> 
</div> 
<div class="m-1 p-1">@RenderBody()</div> 
@await Component. InvokeAsync("PageSize" ) 
</body> 
</html> 





结果 是 由 自己 的 集成 控制 器 (或 者 如 果 喜 欢 ， 
也 可 以 是 具有 上 自己 的 集成 视图 组 件 的 控制 医 ) 备份 
的 视图 组 件 。 如 果 运 行 应 用 程序 ， 你 将 看 到 伦 至 被 
列 为 人 口 最 多 的 城市 。 单 击 Create 按 钮 ， 你 将 看 到 
一 个 表单 ， 可 以 回应 用 程序 添加 新 的 城市 。 填 写 并 
提交 表单 ， 控 制 絮 将 收 到 数据 ， 更 新 存储 库 ， 并 将 
浏览 器 重 定 问 到 应 用 程序 的 默认 URL。 如 果 添 加 入 
口 更 多 的 城市 ， 视 图 组 件 的 输出 结果 将 会 改变 ， 如 
图 22-9 所 示 。 














D) Create city 
< C @ iocalhos: w 
Products Biggest Chie jeron 
City i ] 
Dm $ x 
Name: E C [O locahos t 
Beijing | | 
Biggest Cit Beijing 
Country. 
cr City 
China 
1 Name Price 
Population: z 
| Kayak 275 
Lifejacket 46.95 
x Soccer ball 19.50 
Ea 


图 22-9 ”使 用 混合 的 控制 器 /视图 组 件 类 


22.5 ”小 结 





本 章 介 绍 了 视图 组 件 ， 这 是 ASP.NET Core 
MVC 的 新 增 功能 ， 以 蔡 代 以 前 的 MVC 版 本 的 子 操 
作 功 能 。 本 章 演 示 了 如 何 创建 POCO 视 图 组 件 以 及 
如 何 使 用 ViewComponent 基 类 ， 还 展示 了 组 件 可 以 
生成 的 3 种 不 同类 型 的 结果 ， 包 括 在 父 视 图 中 包含 
分 部 视图 的 选择 。 本 章 最 后 演示 了 如 何 将 视图 组 件 
功能 添加 a 到 控制 右 类 中 ， 以 减少 代码 重复 并 简化 应 
用 程序 。 下 一 章 将 介绍 标签 助手 ， 用 于 在 视图 中 转 
换 HTML 元 素 。 








第 23 间 ”标签 助手 


标签 助手 是 ASP.NET Core MVC 中 引入 的 新 特 
性 ， 用 于 在 视图 中 使 用 C# 类 转换 HTML 元 素 。 通 常 
的 用 法 包括 使 用 应 用 程序 的 路 由 配置 来 为 表单 生成 
URL、 确 保 特定 类 型 的 元 素 样 式 能 够 一 致 地 被 修 
饰 、 将 自 定 义 的 缩写 元 素 符 换 为 常用 的 内 容 片 段 
等 。 本 章 将 介绍 标签 助手 是 如 何 工 作 的 ， 以 及 定制 
的 标签 助手 是 如 何 创建 和 应 用 的 。 第 24 章 将 说 明 内 
置 的 文 持 HIML 表 单 的 标签 助手 ， 第 25 章 将 说 明 
MVC 提 供 的 其 他 内 置 标签 助手 。 表 23-1 介 绍 了 标签 
助手 的 背景 。 














标签 助手 组 件 


ASP.NET Core 2 平台 引入 了 标签 助手 ， 从 而 可 
以 在 肥 送 到 客户 并 的 啊 应 中 修改 特定 的 HTML 乒 
段 ， 它 们 也 可 以 通过 标签 助手 来 使 用 。 因 为 它 难以 
使 用 ， 对 于 大 多 数 MVC 开 发 人 员 来 说 用 处 不 大 ， 所 
以 这 里 不 再 介绍 。 如 果 要 转换 发 送 到 客户 问 的 啊 应 
中 的 内 容 ， 请 使 用 本 章 介 绍 的 标签 助手 特性 。 


表 23-1 标签 助手 的 背景 











ke vt 的 类 ， 可 使 用 某 种 方式 改变 它们 ， 提 供 附加 的 内 
， 也 可 使 用 新 的 内 容 整个 替换 它们 








标签 助手 允许 使 用 C# 加 辑 来 呈现 或 转换 视图 内 容 ， 确 保 发 送 到 客户 端的 
HTML 反 映 应 用 程序 的 状态 











_ | 可 基于 元 素 的 类 名 或 者 使 用 HTMLTargetElement 特 性 来 选择 应 用 标签 助手 的 
“| HTML 元素 。 当 视图 被 呈现 时 ， 元 素 通过 标签 助手 被 转换 并 包含 在 发 送 到 客 











户 端的 HTML 中 





标签 助手 有 




















何 缺 陷 或 限 | 标签 助手 很 容易 被 过 度 使 用 
制 ? 牛 更 易于 做 到 


用 于 生成 复杂 的 HTML 内 容 片 段 ， 使 用 视图 组 












































不 一 定 必须 使 用 标签 助手 ， 但 是 它们 可 以 使 你 在 MVC 应 用 程序 中 更 加 容易 地 
生成 复杂 的 HTML 内 容 





























表 23-2 列 出 了 本 章 要 介绍 的 操作 。 


表 23-2 本 章 要 介绍 的 操作 














代码 清 

















创建 标签 助手 ， 然 后 使 用 @addTagHelper 表 达 式 在 | 代码 清单 23-10 一 
视图 中 或 在 视图 导入 文件 中 进行 注册 代码 清单 23-12 








转换 HTML 元 素 









































管理 标签 助手 的 作 | 代码 清单 23-13 一 
使 用 HtmlTargetElement 特 性 
代码 清单 23-17 




















代码 清单 23-18 和 
代码 清单 23-19 











4 H TagHelperOutputx} & 4 

















为 目标 元 素 插 入 内 代码 清单 23-22 和 
oan se 使 用 TagHelperOutput 提 供 的 Pre- 和 Post- 属 性 
容 或 环绕 内 容 代码 清单 23-23 






































在 标签 助手 中 接收 | 使 用 ViewContext 和 HtmlAttributeNotBound 特 性 装 ”| 代码 清单 23-24 和 
上 下 文 数据 饰 属性 代码 清单 23-25 














清单 23-26 和 
访问 视图 模型 使 用 ModelExpression 属 性 代码 清单 23-27 



































清单 23-28 和 





组 织 标签 助手 使 用 TagHelperContext.Items 属 性 








清单 23-30 和 
码 清单 23-31 





抑制 元 素 使 用 SuppressOutput 方 法 











i | 





23.1 准备 示例 项 目 





在 本 章 中 ， 使 用 ASP.NET Core Web 
Application (.NET Core) 模板 新 建 名 为 Cities 的 
Empty 项 目 。 


23.1.1 创建 模型 和 存储 库 


创建 Models 文 件 夹 ， 添 加 名 为 City.cs 的 类 文 
件 ， 并 用 它 定 义 代码 清单 23-1 所 示 的 类 。 


代码 清单 23-1 Models 文 件 夹 下 的 City.cs 文 件 的 内 容 


namespace Cities.Models { 


public class City { 
public string Name { get; set; } 
public string Country { get; set; } 
public int? Population { get; set; } 





为 了 给 City 对 象 创建 存储 库 ， 在 Models 文 件 夹 
中 添加 名 为 Repository.cs 的 类 文件 ， 并 用 它 定 义 代 
人 码 清单 23-2 所 示 的 接口 和 实现 。 


代码 清单 23-2 ”Models 文 件 夹 下 的 Repository.cs 文 件 的 内 容 





using System.Collections.Generic; 


namespace Cities.Models { 
public interface IRepository { 


TEnumerable<City> Cities { get; } 
void AddCity(City newCity) ; 


} 


public class MemoryRepository : IRepository { 


private List<City> cities = new List<City> { 
new City { Name = "London", Country = "UK", 
Population = 8539000}, 
new City { Name = "New York", Country = "US 
A", Population = 8406000 }, 


new City { Name = "San Jose", Country = "US 
A", Population = 998537 }, 

new City { Name = "Paris", Country = "Franc 
e", Population = 2244000 } 


le 


public IEnumerable<City> Cities => cities; 


public void AddCity(City newCity) { 
cities.Add(newCity) ; 





23.1.2 flees. ASMA 


ASE ZN BIR ap EE AS AE 
Controllers 文 件 夹 ， 添 加 名 为 HomeController.cs 的 
类 ， 然 后 用 它 定 义 代码 清单 23-3 所 示 的 控制 器 。 


代码 清单 23-3 ”Controllers 文 件 夹 下 的 HomeController.cs 文 件 的 
内 容 





using Microsoft.AspNetCore.Mvc; 
using Cities.Models; 


namespace Cities.Controllers { 


public class HomeController : Controller { 


private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 


public ViewResult Index() => View(repository.Ci 
ties); 


public ViewResult Create() => View(); 


[HttpPost ] 

public IActionResult Create(City city) { 
repository .AddCity(city); 
return RedirectToAction("Index") ; 





Fe thll ane GE S Indextk ENTIA H F A h ri EE 
中 的 对 象 ， 一 对 Create 方 法 将 允许 用 户 使 用 表单 来 
创建 新 的 City 对 象 ， 可 延续 使 用 与 前 面 草 节 中 相同 
的 模式 。 

















应 用 程序 中 的 视图 将 使 用 共享 的 布局 。 创 建 
Views/Shared 文 件 夹 ， 在 Views/Shared 文 件 夹 中 添加 
名 为 _Layout.cshtml 的 布局 文件 ， 加 入 代码 清单 23-4 


所 示 的 标记 内容。 


y> zw 
YE T 


本 章 的 目的 是 演示 标签 助手 如 何 工作 ， 布 局 和 
示例 应 用 程序 中 的 视图 仅仅 使 用 标准 的 HTML 元 素 
来 编写 ， 它 们 将 被 介绍 的 其 他 标签 助手 殖 换 。 


代码 清单 23-4 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 件 的 


内 容 





<!DOCTYPE html> 
<html> 
<head> 


<meta name="viewport" content="width=device-width" 


/> 
<title>Cities</title> 


<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
<div>@RenderBody()</div> 
</body> 
</html> 





SRG, fll¥EViews/Home CHEM, WIA 
Index.cshtml 的 文件 ， 内 容 如 代码 清单 23-5 所 示 。 


代码 清单 23-5 “Views/Home 文 件 夹 下 的 Index.cshtml 文 件 的 内 


IP 


谷 





@model IEnumerable<City> 


@{ Layout = " Layout"; } 


<table class="table table-sm table-bordered"> 
<thead class="bg-primary text-white"> 
<tr> 
<th>Name</th> 
<th>Country</th> 
<th class="text-right">Population</th> 
</tr> 
</thead> 
<tbody> 
@foreach (var city in Model) { 
<tr> 
<td>@city .Name</td> 
<td>@city.Country</td> 


<td class="text-right">@city.Population 
?. TOString ("#, ###")</td> 
</tr> 


} 
</tbody> 
</table> 
<a href="/Home/Create" class="btn btn-primary">Create</ 
a> 





Index 视 图 使 用 City 对 象 的 序列 来 填充 表格 ， 还 
包含 一 个 a 元 了 素 用 来 指 问 URL 地 址 /Home/Create，a 
元 素 已 使 用 Bootstrap 修 饰 为 按钮 样式 。 对 于 第 二 个 
视图 ， 添 加 名 为 Create.cshtml 的 文件 到 Views/Home 
文件 夹 中 ， 内 容 如 代码 清单 23-6 所 示 。 





代码 清单 23-6 ”Views/Home 文 件 夹 下 的 Create.cshtml 文 件 的 内 


IP 


谷 





@model City 


@{ Layout = " Layout"; } 


<form method="post" action="/Home/Create" > 
<div class="form-group"> 
<label for="Name">Name:</label> 
<input class="form-control" name="Name" /> 
</div> 
<div class="form-group"> 


<label for="Country">Country:</label> 
<input class="form-control" name="Country" /> 
</div> 
<div class="form-group"> 
<label for="Population">Population:</label> 
<input class="form-control" name="Population" / 


</div> 


<button type="submit" class="btn btn-primary">Add</ 
button> 


<a class="btn btn-primary" href="/Home/Index">Cance 
l</a> 
</form> 





这 里 还 在 Views 文 件 夹 中 创建 了 名 为 
_ViewImports.cshtml 的 视图 导入 文件 ， 在 其 中 添加 
代码 清单 23-7 所 示 的 表达 式 。 这 人 允许 引用 Models 文 
件 夹 中 的 类 而 不 需要 使 用 命名 空间 。 





代码 清单 23-7 Views 文 件 夹 下 的 _ViewImports.cshtml 文 件 的 内 


IP 


AY 


@using Cities.Models 


示例 项 目 中 的 视图 基于 Bootstrap CSS 包 。 为 了 





将 BootStrap 添 加 到 示例 项 目 中 ， 使 用 Bower 
Configuration File 模 板 在 项 目的 根 目录 中 创建 名 为 
bower.json 的 文件 ， 并 添加 代码 清单 23-8 所 示 的 包 到 


dependencies 部 分 。 


代码 清单 23-8 在 Cities 文 件 夹 下 的 bower.json 文 件 中 添加 
Bootstrap 
{ 


"name": "asp.net", 
"private": true, 


"dependencies": { 
"bootstrap": "4.0.0-alpha.6" 
} 





} 
23.1.3 配置 应 用 程序 


最 终 的 准备 步骤 是 配置 应 用 程序 ， 如 代码 清单 
23-9 所 示 。 本 书 在 所 有 示例 项 目 中 使 用 同样 的 基本 
配置 ， 男 外 使 用 单 例 生命 周期 作为 服务 注册 存储 
FF 








using 
using 
using 
using 
using 
using 
using 
using 
using 


代码 清单 23-9 “Cities 文件 夹 下 的 Startup.cs 文 件 的 内 容 


System; 

System.Collections.Generic; 

System. Ling; 

System. Threading.Tasks; 
Microsoft.AspNetCore. Builder; 
Microsoft.AspNetCore.Hosting; 
Microsoft.AspNetCore.Http; 
Microsoft.Extensions.DependencyInjection; 
Cities.Models; 


namespace Cities { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 


n services) { 


services.AddSingleton<IRepository, MemoryRe 


pository>(); 


services.AddMvc(); 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 

app.UseStatusCodePages() ; 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 





如 果 运 行 应 用 程序 ， 将 会 显示 来 目 和 存储 库 默认 


创建 的 City 对 象 的 清单 。 单 击 Create 按 钮 ， 填 写 表 
单 ， 然 后 单 击 Add 投 钮 ， 新 的 对 象 将 会 家 添加 到 作 
储 库 中 ， 如 图 23-1 所 示 。 














图 23-1 ”运行 应 用 程序 
23.2 创建 标签 助手 


与 许多 的 MVC 特 性 一 样 ， 理 解 标 俭 助手 的 最 
佳 方式 就 是 创建 它们 ， 这 可 以 揭示 它们 是 如 何 运 作 
以 及 融入 应 用 程序 的 。 后 面 将 介绍 创建 和 应 用 标签 
助手 的 过 程 ， 将 为 button 元 素 应 用 Bootstrap CSS 样 
式 ， 以 便 对 如 下 元 素 进行 转换 : 


<button type="submit" bs-button-color="danger">Add</but 


ton> 





转换 后 的 形式 如 下 : 


<button type="submit" class="btn btn-danger">Add</butto 


n> 





标签 助手 将 会 识别 bs-button-color 属 性 ， 然 后 使 
用 访 属 性 的 全 设置 及 送 到 浏览 器 的 元 素 的 class 属 
性 。 这 种 转换 虽然 不 是 很 有 用 ， 但 可 以 为 说 明 标 签 
助手 如 何 工 作 打 下 基础 。 











23.2.1 和 定义 标签 助手 类 


标签 助手 可 以 在 项 目的 任何 位 置 定 义 ， 但 将 它 
们 保存 在 一 起 是 有 帮助 的 ， 与 大 多 数 MVC 组 件 不 
同 ， 它 们 在 使 用 之 前 需要 注册 。 在 
Infrastructure/TagHelpers 文 件 夹 中 创建 这 些 标 俭 助 








手 ， 并 将 它们 添加 到 项 目 中 。 


标签 助手 类 需要 派生 上 自 TagHelper 类 ,日 定义 
在 命名 空间 Microsoft.AspNetCore.Razor.TagHelpers 
中 。 为 了 创建 标签 助手 ， 在 
Infrastructure/TagHelpers 3¢ 43% P AIA WN 
ButtonTagHelper.cs 的 文件 ， 然 后 用 它 定 义 代码 清单 
23-10 所 示 的 类 。 





代码 清单 23-10 Infrastructure/TagHelpers 文 件 严 下 的 
ButtonTagHelper.cs 文 件 的 内 容 





using Microsoft.AspNetCore.Razor.TagHelpers; 


namespace Cities.Infrastructure.TagHelpers { 
public class ButtonTagHelper : TagHelper { 
public string BsButtonColor { get; set; } 
public override void Process(TagHelperContext c 


ontext, 
TagHelperOutput ou 


tput) { 


output.Attributes.SetAttribute("class", $"b 


tn btn-{BsButtonColor}") ; 


} 
} 


TagHelper 类 定义 了 Process 方 法 ， 该 方法 可 由 
子 类 重 写 以 实现 转换 元 系 的 行为 。 标 签 助 手 的 名 称 
由 被 转换 元 素 的 名 称 加 上 TagHelper 组 成 。 在 这 个 示 
例 中 ， 类 名 ButtonTagHelper 告 诉 MVC 这 是 用 于 转换 
button 元 素 的 标签 助手 。 标 俭 助手 的 作用 域 可 以 使 
用 特性 进行 拓宽 或 限制 ， 这 里 是 默认 行为 。 


二 


fe ” 示 


异步 标签 助手 可 以 通过 重 写 ProcessAsync 方 法 
而 不 是 Process 方 法 来 创建 ， 但 是 对 大 多 数 标签 助手 
是 不 必要 的 ， 而 倾向 于 创建 小 的 且 专 注 于 改变 的 


HTML 元 素 。 默 认 的 ProcessAsync 实 现 会 调用 
Process 方 法 。 


1. 接收 上 下 文 数据 


标签 助手 通过 TagHelperContext 类 的 实例 来 接 
收 关 于 转换 元 素 的 信息 ， 实 例 可 作为 Process 方 法 的 
参数 接收 ， 且 定义 了 表 23-3 定 义 的 属性 。 





表 23-3 ”TagHelperContext 类 定义 的 属性 


























pe 
passion | 习 一 个 只 读 的 待 转换 元 素 的 特性 字典 ， 以 属性 名 称 作为 索引 
| IARTA 









































返回 待 转换 元 素 的 唯一 标识 

















素 的 属性 详情 ， 但 更 方便 的 方式 是 定义 一 个 属性 ， 
属性 名 对 应 你 感 兴趣 的 元 系 属 性 ， 如 下 所 示 : 








public string BsButtonColor { get; set; } 


当 标 签 助 手 被 应 用 时 ，MVC 检 查 标签 助手 类 
定义 的 属性 ， 并 使 用 名 称 得 到 完整 下 配 的 HTML 元 
系 属 性 的 值 来 设置 。 作 为 上 述 处 理 过 程 的 一 部 分 ， 
MVC 将 试图 转换 HTML 属 性 的 值 为 C# 属 性 的 类 型 ， 
bool 类 型 的 属性 可 以 接收 HTML 属 性 的 true 或 false 
值 ，int 类 型 的 属性 可 以 接收 类 似 于 1 和 2 的 HTML 属 
性 但。 








HTML Helper 发 后 了 什么 ? 


早期 版 本 的 ASP.NET MVC 使 用 HTML helper 来 


生成 表 早 元 素 。HTML helper 是 一 组 通过 Razor 表 达 
式 访问 的 以 @Html 开 始 的 方法 ， 创 建 input 元 素 并 填 
充 属 性 的 方式 可 能 如 下 所 示 : 


@Htm1.TextBoxFor(m => m.Population) 


HTML ee 问题 是 它们 不 适合 
HTML 元 条 的 结构 ， 这 导致 表达 式 十 分 牺 拙 ， 类 似 
于 下 面 这 样 : 


@Html.TextBoxFor(m => m.Population, new { @class = "for 


m-control" }) 








属性 不 得 不 表示 为 动态 对 象 ， 并 且 如 果 名 称 为 
C# 保 留 字 ， 例 如 class， 那 么 不 得 不 使 用 @ 前 级 。 由 
于 HIML 元 系 需 要 变 得 越 来 越 复 杂 ，HIML helper 
an 标签 助手 通过 使 用 HTML 
属性 避免 了 这 一 点 ， 类 似 于 下 面 这 样 : 





<input class="form-control" asp-for="Population" /> 








结果 就 是 生成 更 目 然 的 HTML， 并 且 处 理 的 视 
图 也 更 易 读 和 多 于 理解 。MVC 仍 然 文 持 HTML 
helper《〈 并 且 标 俭 助手 在 项 后 使 用 HTML helper) , 
可 以 在 原来 开发 的 MVC5 视 图 中 继续 使 用 HTML 
Helper 来 实现 后 回 兼 容 性 ， 但 是 ， 新 的 视图 应 当 使 
用 标签 助手 。 








属性 的 名 称 会 从 默认 的 HIML 风 格 执行 自动 转 
换 ， 比 如 从 bs-button-color 转 换 为 C# 风 格 的 
BsButtonColor。 可 以 使 用 除了 asp-《〈 由 微软 使 用 ) 
和 data《〈 由 发 送 到 客户 端的 自 定 义 属 性 保留 ) 以 外 
的 任何 前 级 。 本 例 的 Process 方 法 使 用 BsButtonColor 
属性 来 接收 应 用 于 button 元 素 的 颜色 模式 ， 如 下 所 


ZN: 


output.Attributes.SetAttribute("class", $"btn btn-{BsBu 





ttonColor}"); 


没有 关联 HTML 属 性 的 属性 值 不 会 被 设置 ， 这 
意味 着 应 当 检 查 并 确认 没有 在 处 理 null 或 默认 值 。 


o 
ER 


使 用 HIML 属 性 名 称 用 于 标签 助手 属性 并 不 总 
是 导致 易 读 或 易于 理解 的 类 。 可 以 使 用 
HtmlAttributeName 特 性 来 打破 属性 名 称 与 其 表示 的 
属性 之 间 的 联系 ， 从 而 用 来 指定 属性 将 要 表示 的 
HTML 属 性 。 








2. 产生 输出 








Process 方 法 通过 配置 作为 参数 接收 的 
TagHelperOutput 对 象 来 转换 元 素 。TagHelperOuput 
从 自身 在 Razor 视 图 中 出 现 的 位 置 开 始 输出 HIML 元 
系 ， 并 通过 表 23-4 所 示 的 属性 和 方法 来 改变 元 素 。 


表 23-4 ”TagHelperOutput 类 定义 的 属性 和 方法 


win | ay TER EH T 7c 8 J PE 



























































该 属性 返回 TagHelperContent 对 象 ， 用 于 设置 元 素 内 容 
该 属性 返回 TagHelperContent 对 象 ， 用 于 在 视图 中 输出 元 素 之 前 插入 内 容 
该 属性 返回 TagHelperContent 对 象 ， 用 于 在 视图 中 输 





















































PreContent 该 属性 返回 TagHelperContext 对 象 ， 用 于 在 输出 元 素 的 内 容 之 前 插入 内 容 

















该 属性 返回 TagHelperContext 对 象 ， 用 于 在 输出 元 素 的 内 容 之 后 插 



































出 元 素 的 输出 编写 方式 ， 可 使 用 来 自 TagMode 枚 举 的 值 




















在 ButtonTagHelper 类 中 ， 可 使 用 Attributes 字 — 典 
ee O 元 素 中 ， 用 于 
按钮 样式 ， 包 含 来 自 BsButtonColor 属 性 的 值 ， 

味 看 可 以 使 用 E 称 〈 比 如 primary、info、 
和 danger) Ks AIA A AE o 





23.2.2 ”注册 标签 助手 


标签 助手 类 只 有 在 使 用 Razor 的 @addTagHelper 
表达 式 注 册 之 后 才能 使 用 。 被 应 用 的 视图 集 将 基于 
@addTagHelper 表 达 式 的 应 用 位 置 。 对 于 单个 视 
图 ， 表 达 式 出 现在 视图 本 映 之 中 。 对 于 应 用 程序 中 

















的 一 组 视图 ， 表 达 式 出 现在 包含 这 些 视 图 的 文件 夹 
或 父 文件 夹 中 名 ree KPE 
比如 ，/Views/Home/_ViewImports.cshtml 文 件 中 使 
用 @addTagHelper 表 达 式 注册 的 标签 助手 将 作用 于 
Home 控 制 右 的 所 有 视图 。 为 了 让 本 章 创 建 的 标签 
助手 可 以 被 整个 应 用 程序 中 的 视图 使 用 ， 在 
Views/_ViewImports.cshtml 文 件 深 加 @addTagHelper 
表达 式 ， 如 代码 清单 23-11 所 示 。 














代码 清单 23-11 在 Views 文 件 夹 下 的 _ViewImports.cshtml 文 件 
中 注册 标签 助手 








参数 的 第 一 部 分 指定 了 标签 助手 的 类 名 ， 文 持 
通配符 ;第 二 部 分 指定 了 定义 所 在 的 程序 集 名 称 
以 上 代码 注册 了 Cities 程 序 集中 命名 空间 
Cities.Infrastructure.TagHelpers 里 的 所 有 标签 助手 。 





23.2.3 ”使 用 标签 助手 








终 的 步 又 是 使 用 标签 助手 转换 元 系 。 代 人 码 清 
e RI button zt% P A 
除了 class 必 性， 痊 换 为 ButtonTagHelper 类 中 定义 的 
属性 


代码 清单 23-12 ”在 Views/Home 文 件 夹 下 的 Create.cshtml 视 图 文 
件 中 使 用 标签 助手 








@model City 


@{ Layout = " Layout"; } 


<form method="post" action="/Home/Create" > 
<div class="form-group"> 
<label for="Name">Name:</label> 
<input class="form-control" name="Name" /> 
</div> 
<div class="form-group"> 
<label for="Country">Country:</label> 
<input class="form-control" name="Country" /> 
</div> 
<div class="form-group"> 
<label for="Population">Population:</label> 
<input class="form-control" name="Population" / 


</div> 


<button type="submit" bs-button-color="danger">Add< 
/button> 

<a class="btn btn-primary" href="/Home/Index">Cance 
l</a> 
</form> 





如 果 运 行 应 用 程序 ， 单 击 Create 按 钮 ， 浏 览 莫 
将 会 访问 /Home/Create， 你 将 会 看 到 Add 按 钮 的 茵 
色 和 样式 发 生 了 变化 ， 如 图 23-2 所 示 。 


Population: 





图 23-2 ”使 用 标签 助手 修饰 按钮 


测 试 标签 助手 


用 于 标签 助手 的 单元 测试 是 一 个 相对 简单 的 过 
程 。 下 面 是 为 代码 清单 23-12 所 示 的 标签 助手 提供 


的 示例 测试 : 





using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Cities.Infrastructure. TagHelpers ; 
using Microsoft.AspNetCore.Razor.TagHelpers; 
using Xunit; 


namespace Cities.Tests { 
public class TagHelperTests { 


[Fact] 
public void TestTagHelper() { 
// Arrange 
var context = new TagHelperContext( 
new TagHelperAttributeList(), 
new Dictionary<object, object>(), 
"myuniqueid" ); 


var output = new TagHelperOutput("button", 
new TagHelperAttributeList(), (cache, e 
ncoder) => 
Task. FromResult<TagHelperContent> 
(new DefaultTagHelperContent() ) 


); 


// Act 

var tagHelper = new ButtonTagHelper { 
BsButtonColor = "testValue" 

}; 


tagHelper.Process(context, output) ; 


// Assert 
Assert.Equal($"btn btn-{tagHelper.BsButtonC 


output.Attributes[ "class" ].Value) ; 





在 以 上 单元 测试 中 ， 多 数 工作 是 设置 
TagHelperContext 和 TagHelperOutput 对 象 ， 以 便 它 
们 可 以 被 传递 给 标签 助手 的 Process 方 法 ， 以 检查 并 
确 你 HIML 元 素 补 正确 转换 。 准 备用 于 测试 的 标签 
助手 所 需 的 工作 量 自然 取决 于 它们 所 操作 的 HTML 
的 复杂 性 以 及 转换 程度 。 但 是 ， 大 多 数 标签 助手 相 
对 简单 ， 可 以 按照 前 面 讲述 的 基本 模式 进行 测试 。 








23.2.4 ”管理 标签 助手 的 作用 域 





标签 助手 将 被 应 用 于 给 定 类 型 的 所 有 元 素 ， 这 
意味 着 之 前 创建 的 ButtonTagHelper 类 的 Process 方 


法 ， 将 由 应 用 程序 中 每 个 视图 的 每 个 button 元 系 调 
用 。 这 不 总 是 有 用 的 。 为 了 针对 这 个 问题 提供 示 
例 ， 在 Create.cshtml 文 件 中 添加 另 一 个 button 元 素 ， 
如 代码 清单 23-13 所 示 。 








代码 清单 23-13 ”在 Views/Home 文 件 夹 下 的 Create.cshtm]l 文 件 中 
添加 另 一 个 button 元 素 





@model City 


@{ Layout = " Layout"; } 


<form method="post" action="/Home/Create" > 
<div class="form-group"> 
<label for="Name">Name:</label> 
<input class="form-control" name="Name" /> 
</div> 
<div class="form-group"> 
<label for="Country">Country:</label> 
<input class="form-control" name="Country" /> 
</div> 
<div class="form-group"> 
<label for="Population">Population:</label> 
<input class="form-control" name="Population" / 


</div> 


<button type="submit" bs-button-color="danger" >Add< 
/button> 


<button type="reset" class="btn btn-primary" >Reset 
</button> 

<a class="btn btn-primary" href="/Home/Index">Cance 
l</a> 
</form> 





新 的 button GR CAMA class 属性 ， 并 且 不 
需要 通过 ButtonTagHelper 类 执行 转换 。 但 是 ， 如 果 
运行 应 用 程序 并 导航 到 URL 地 址 /Home/Create， 你 
将 会 看 到 有 问题 产生 ， 如 图 23-3 所 示 。 





Population: 


图 23-3 ”标签 助手 的 默认 作用 域 的 效果 


可 以 通过 查看 发 送 到 浏览 器 的 HTML 来 查看 格 
式 缺 失 的 原因 ， 这 揭示 了 class 属 性 的 问题 ， 如 下 所 
JR: 





<button type="reset" class="btn btn-">Reset</button> 


MVC 应 用 ButtonTagHelper 到 新 的 button 元 素 ， 
但 是 由 于 HIML 元 素 没有 相应 的 bs-button-color 属 
性 ， 因 此 没有 设置 BsButtonColor 属 性 的 值 。 结 果 ， 
标签 助手 使 用 不 正确 的 Bootstrap 样 式 蔡 换 class 属 
性 ， 生 成 格式 缺失 的 元 陛 。 











1. 限制 标签 助手 的 作用 域 


解决 这 个 问题 有 两 种 方式 。 一 种 方式 是 修改 
ButtonTagHelper 类 ， 以 使 其 对 可 能 过 到 的 button 元 
素 敏 感 。 对 于 示例 应 用 程序 来 说 ， 这 需要 增加 额外 
的 检查 ， 例 如 确认 是 否 拥 有 bs-button-color 属 性 ， 并 
确保 在 定义 了 class 属 性 之 后 不 会 被 蔡 换 掉 。 这 种 方 
式 的 问题 在 于 ， 随 着 包含 button 元 素 的 视图 不 断 添 
加 到 应 用 程序 中 ， 标 和 俭 助手 类 会 变 得 越 来 越 复杂 ， 
并 且 基 于 ButtonTagHelper 的 所 有 新 添加 的 额外 复杂 
条 件 描 述 并 不 执行 转换 。 














另 一 种 方式 是 允许 标签 助手 描述 对 使 用 方式 的 
限制 ， 缩 小 作用 域 。 可 使 用 HtmlTargetElement 特 性 
限制 标签 助手 的 作用 域 ， 如 代码 清单 23-14 所 示 。 


代码 清单 23-14 ”限制 mnfrastructure/TagHelpers 文 件 夹 下 的 
ButtonTagHelper.cs 的 作用 域 


using Microsoft.AspNetCore.Razor.TagHelpers; 


namespace Cities.Infrastructure.TagHelpers { 


[HtmlTargetElement("button", Attributes = "bs-butto 
n-color", ParentTag = "form")] 


public class ButtonTagHelper : TagHelper { 


public string BsButtonColor { get; set; } 


public override void Process(TagHelperContext c 
ontext, 


TagHelperOutput ou 
tput) { 


output.Attributes.SetAttribute("class", $"b 
tn btn-{BsButtonColor}") ; 
} 
} 








HtmlTargetElement 特 性 描述 了 标签 助手 应 用 的 








元 素 。 第 一 个 参数 指定 了 元 素 类 型 ， 并 文 持 表 23-5 
所 示 的 额外 属性 。 


表 23-5” HtmlTargetElement 特 性 支持 的 属性 


日 于 指定 标签 助手 应 作用 于 拥有 给 定 属性 集 的 指定 元 素 ， 可 使 用 以 喜 号 分 隔 


Attributes 属性 的 列表 来 提供 。 元 素 必 须 拥有 全 部 指定 的 属性 。 以 星 号 结束 的 属性 名 称 
将 被 视 为 前 缀 ， 所 以 bs-button-* 将 匹配 bs-button-color、bs-button-size 等 





























































































































prana |i 指定 类 型 元 素 的 元 素 


ee 用 于 指定 标签 助手 仅 应 作用 于 元 素 标 记 结 构 对 应 于 TagStructure 枚 举 中 给 定 值 
agStructure| | We 
的 元 素 ， 其 中 定义 了 Unspecified、NormalOrSelfClosing 和 WithoutEndTag 





























代码 清单 23-14 限 制 了 ButtonTagHelper 类 仅 作 
用 于 父 元 系 是 form 元 素 ， 且 拥有 bs-button-color 属 性 
的 button 元 素 。 如 果 运 行 应 用 程序 并 导航 
到 /Home/Create， 你 将 看 到 Reset 按钮 因为 缺失 要 
求 的 属性 而 不 再 被 转换 ， 如 图 23-4 所 示 。 








ropulation: 


aad | Reset | canci 
图 23-4 ”限制 标签 助手 的 作用 域 


特性 HtmlTargetElement 也 可 以 用 来 拓宽 标签 助 
手 的 作用 域 ， 以 便 匹 配 更 广泛 的 元 素 。 当 需要 对 多 
| 这 是 很 有 用 
的 。 这 与 基于 标签 助手 类 名 匹配 元 素 的 前 提 相 违 
痛 ， 如 代码 清单 23-15 所 示 。 

















代码 清单 23-15 ”在 Infrastructure/TagHelpers 文 件 夹 下 的 
ButtonTagHelper.cs 中 拓宽 标签 助手 的 作用 域 





using Microsoft.AspNetCore.Razor.TagHelpers; 


namespace Cities.Infrastructure.TagHelpers { 


[HtmlTargetElement(Attributes = "bs-button-color", 
ParentTag = "form")] 
public class ButtonTagHelper : TagHelper { 


public string BsButtonColor { get; set; } 


public override void Process(TagHelperContext c 
ontext, 


TagHelperOutput ou 
tput) { 


output.Attributes.SetAttribute("class", $"b 
tn btn-{BsButtonColor}") ; 


} 








以 J ts 了 HtmlTargetElement 中 的 元 素 类 
型 ， 这 意味 着 标 签 助手 将 个 应 用 于 任何 拥有 bs- 
button- color 属 性 的 元 系 ， 而 无 论 元 素 的 类 型 如 何 。 
代码 清单 23-16 修 改 了 表单 中 的 a 元 素 ， 使 用 与 按钮 
元 素 相 同 的 Bootstrap 样 式 集 ， 以 便 可 以 由 标签 助手 
进行 转换 。 








代码 清单 23-16 ”在 Views/Home 文 件 夹 下 的 Create.cshtml 文 件 中 
修改 销 元 素 


@model City 


@{ Layout = " Layout"; } 


<form method="post" action="/Home/Create"> 
<div class="form-group"> 
<label for="Name">Name:</label> 
<input class="form-control" name="Name" /> 
</div> 
<div class="form-group"> 
<label for="Country">Country:</label> 
<input class="form-control" name="Country" /> 
</div> 
<div class="form-group"> 
<label for="Population">Population:</label> 
<input class="form-control" name="Population" / 


</div> 


<button type="submit" bs-button-color="danger" >Add< 
/button> 

<button type="reset" class="btn btn-primary" >Reset 
</button> 

<a bs-button-color="primary" href="/Home/Index">Can 
cel</a> 
</form> 











标签 助手 的 作用 域 更 广泛 意味 着 对 于 不 同类 型 
的 元 系 不 必 重 复 同 样 的 操作 。 但 是 注意 ， 应 用 程序 
中 的 视图 内 容 在 演进 的 时 候 ， 很 容易 创建 下 配 过 于 
宽泛 的 元 素 的 标签 助手 。 更 平衡 的 方式 是 应 用 多 次 
HtmlTargetElement 特 性 ， 以 组 合 限制 定义 匹配 的 方 




















式 指 定 元 素 的 完整 集合 ， 如 代码 清单 23-17 所 示 。 


代码 清单 23-17 在 Infrastructure/TagHelpers 文 件 夹 下 的 
ButtonTagHelper.cs 文 件 中 平衡 标签 助手 的 作用 域 


using Microsoft.AspNetCore.Razor.TagHelpers; 
namespace Cities.Infrastructure.TagHelpers { 


[HtmlTargetElement("button", Attributes = "bs-butto 
n-color", ParentTag = "form")] 

[HtmlTargetElement("a", Attributes = "bs-button-col 
or", ParentTag = "form")] 

public class ButtonTagHelper : TagHelper { 


public string BsButtonColor { get; set; } 


public override void Process(TagHelperContext c 
ontext, 
TagHelperOutput ou 


tput) { 


output.Attributes.SetAttribute("class", $"b 
tn btn-{BsButtonColor}") ; 


} 


} 








上 述 配 置 对 应 用 程序 有 着 同样 的 效果 ， 但 请 确 
保 在 未 来 的 开 肥 过 程 中 ， 出 于 其 他 的 原因 添加 bs- 





button-color 属 性 到 其 他 元 素 时 不 会 导致 问题 。 


排序 标 俭 助手 的 执行 


作为 一 般 原 则 ， 好 的 做 法 是 对 于 特定 的 HTML 
元 系 最 好 仪 仪 应 用 一 个 标签 助手 ， 这 是 因为 很 容易 
导致 一 个 标签 助手 破坏 男 一 个 标签 助手 的 情况 。 如 
果 需 要 应 用 多 个 标签 助手 ， 那 么 通过 设置 Order 属 
性 可 以 控制 执行 的 顺序 。 管 理 执 行 顺序 可 以 帮助 你 
在 标签 助手 之 间 最 小 化 冲突 ， 虽 然 仍 然 容易 导致 问 


题 。 


23.3 ”局 级 标签 助手 特性 


前 面 演示 了 如 何 创建 基本 的 标签 助 手 ， 但 古 仅 











仅 展 示 了 表面 的 可 能 性 ， 后 面 将 展示 标签 助手 提供 
的 更 高 级 的 用 法 和 特性 。 








23.3.1 创建 缩写 元 素 





标签 助手 并 不 限于 转换 标准 HTML 元 系 ， 也 可 
以 用 来 转换 音 用 内 容 的 目 定 义 元 系 。 这 是 一 个 使 得 
创建 更 简洁 、 意 图 更 明显 的 视图 的 有 用 特性 。 为 了 
演示 ， 使 用 目 定 义 元 系 答 换 Create.cshtml 文 件 中 的 
button 元 素 ， 如 代码 清单 23-18 所 示 。 





























代码 清单 23-18 ”在 Create.cshtml 文 件 中 添加 自 定 义 元 素 





@model City 


@{ Layout = " Layout"; } 


<form method="post" action="/Home/Create" > 
<div class="form-group"> 
<label for="Name">Name:</label> 
<input class="form-control" name="Name" /> 
</div> 
<div class="form-group"> 
<label for="Country">Country:</label> 
<input class="form-control" name="Country" /> 


</div> 

<div class="form-group"> 
<label for="Population">Population:</label> 
<input class="form-control" name="Population" / 


</div> 
<formbutton type="submit" bg-color="danger" /> 
<formbutton type="reset" /> 
<a bs-button-color="primary" href="/Home/Index">Can 
cel</a> 
</form> 











formbutton 元 素 不 是 HTML 规范 的 一 部 分 ， 也 
不 被 浏览 絮 所 理解 。 相 反 ， 使 用 这 些 元 系 作 为 生成 
表单 所 需 的 button 元 素 的 缩写 。 在 
Infrastructure/TagHelper 文 件 夹 中 琴 加 一 个 名 为 
FormButtonTagHelper.cs 的 类 文件 ， 并 用 它 定 义 代码 
清单 23-19 所 示 的 类 。 





代码 清单 23-19 Infrastructure/TagHelpers 文 件 夹 下 的 
FormButtonTagHelper.cs 文 件 的 内 容 





using Microsoft.AspNetCore. Razor. TagHelpers; 


namespace Cities.Infrastructure.TagHelpers { 


[HtmlTargetElement("formbutton" ) ] 


public class FormButtonTagHelper : TagHelper { 
public string Type { get; set; } = "Submit"; 


public string BgColor { get; set; } = "primary" 


public override void Process(TagHelperContext c 

ontext, 
TagHelperOutput ou 

tput) { 


output.TagName = "button"; 

output.TagMode = TagMode.StartTagAndEndTag; 

output.Attributes.SetAttribute("class", $"b 
tn btn-{BgColor}"); 

output.Attributes.SetAttribute("type", Type 
); 

output.Content.SetContent(Type == "submit" 
? "Add" : "Reset"); 

Í 


} 





je ” 示 





当 处 理 不 是 HIML 规 范 一 部 分 的 目 定 义 元 系 
时 ， 必 须 应 用 HtmlTargetElement 特 性 ， 并 指定 元 素 
名 称 ， 如 代码 清单 23-19 所 示 。 基 于 类 型 将 标签 助 
手 应 用 到 元 素 的 便捷 方式 仅仅 适用 于 标准 元 又 名 
称 。 











Process 方 法 使 用 TagHelperOuput 对 象 的 属性 来 
生成 复杂 的 不 同 元 素 : TagName 属 性 用 于 指定 
button 元 系 ，TagMode 属 性 用 于 指定 元 素 使 用 开始 
和 结束 标记 写 入 。Attributes.SetAttribute 方 法 用 于 定 
义 Bootstrap 样 式 的 class 属 性 ，Content 必 性 用 于 设置 
元 素 内 容 。 


G 


fe ” 示 


代码 清单 23-19 设 置 了 输出 元 素 的 type 属 性 。 这 
在 输出 元 系 中 忽略 了 标签 助手 定义 的 任何 属性 ， 这 
通常 是 个 好 主意 ， 因 为 阻止 了 用 于 标签 助手 的 属性 
出 现在 发 送 给 浏览 器 的 HIML 中 。 但 是 ， 在 这 种 情 
况 下 需要 使 用 type 属 性 来 配置 标签 助手 ， 以 便 它 们 
出 现在 输出 元 素 中 。 





设置 TagName 属 性 是 很 重要 的 ， 因 为 对 于 自 定 
义 元 素 ， 输 出 元 素 默认 使 用 同样 的 样式 。 代 码 清 单 
23-19 使 用 了 目 结束 标记 : 


<formbutton type="submit" bg-color="danger" /> 
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TagMode.StartTagAndEndTag 枚 举 值 ， 以 便 分 离开 
始 和 结束 标记 。 


Content 属 性 会 返回 一 个 TagHelperContent 实 
例 ， 用 来 设置 元 素 的 内 容 。 表 23-6 列 出 了 
TagHelperContent 定 义 的 主要 方法 。 


表 23-6 ”TagHelperContent 定 义 的 主要 方法 





设置 输出 元 素 的 内 容 ， 字 符 串 参数 将 被 编码 以 便 被 HTML 元 素 安全 
包含 


SetHtmlContent(html) | 设置 输出 元 素 的 内 容 ， 字 符 串 参数 假定 已 经 安全 编码 ， 要 慎 用 























SetContent(text) 












































Append(text) 安全 编码 指定 的 字符 串 ， 并 添加 到 输出 元 素 的 内 容 中 




















添加 指定 的 字符 串 到 输出 元 素 的 内 容 中 ， 而 不 执行 任何 编码 ， 要 慎 
用 


删除 输出 元 素 的 内 容 


AppendHtml(html) 





在 代码 清单 23-19 中 ， 标 签 助手 基于 type 特 性 的 
值 ， 使 用 SetContent 方 法 来 设置 输出 元 系 的 内 容 ， 
值 由 Type 属 性 提供 。 如 果 运 行 应 用 程序 ， 并 访 
问 /Home/Create， 你 将 会 看 到 目 定 义 的 formbutton 元 
素 将 被 替换 为 标准 的 HTML 元 素 ， 所 以 需要 转换 以 
下 元 素 : 


<formbutton type="submit" bg-color="danger" /> 


<formbutton type="reset" /> 








转换 后 的 元 素 如 下 : 


<button class="btn btn-danger" type="submit">Add</butto 
n> 


<button class="btn btn-primary" type="reset">Reset</but 
ton> 





23.3.2 ”前 置 和 追加 内 容 与 元 素 


TagHelperOutput 类 提供 了 四 个 属性 ， 使 得 更 容 
易 在 视图 中 注入 新 的 内 容 ， 以 便 环绕 元 素 或 内 容 ， 








如 表 23-7 所 示 。 后 面 将 说 明 如 何在 目标 元 素 中 插入 
内 容 。 





表 23-7 用 于 添加 内 容 与 元 素 的 TagHelperOutput 属 性 




















re 














re 
于 在 目标 元 素 的 任何 现存 内 容 之 前 插入 内 容 
于 在 目标 元 素 的 任何 现存 内 容 之 后 插入 内 容 


1. 在 环绕 的 输出 元 素 中 插入 内 容 






































第 一 组 TagHelperOuput 属 性 是 PreElement 和 和 
PostElement， 它 们 用 来 在 输出 元 又 之 前 和 之 后 插入 
TER EVRA. CENT, USDA 
ContentWrapperTagHelper.cs 的 类 文件 ， 并 用 它 创 建 
代码 清单 23-20 所 示 的 标签 助手 闫 。 








代码 清单 23-20 ”Infrastructure/TagHelpers 文 件 夹 下 的 
ContentWrapperTagHelper.cs 文 件 的 内 容 





using Microsoft.AspNetCore.Mvc.Rendering; 
using Microsoft.AspNetCore. Razor. TagHelpers; 


namespace Cities.Infrastructure.TagHelpers { 


[HtmlTargetElement("div", Attributes = "title")] 
public class ContentWrapperTagHelper : TagHelper { 


public bool IncludeHeader { get; set; } 
public bool IncludeFooter { get; set; } 


true; 
true; 


public string Title { get; set; } 


public override void Process(TagHelperContext c 
ontext, 
TagHelperOutput ou 


tput) { 

output.Attributes.SetAttribute("class", "m- 
1 p-1"); 

TagBuilder title = new TagBuilder("h1"); 

title.InnerHtml.Append(Title) ; 

TagBuilder container = new TagBuilder( "div" 
) ; 

container.Attributes["class"] = "bg-info m- 
1 p-1"; 


container. InnerHtml.AppendHtm1 (title) ; 


if (IncludeHeader) { 
output .PreElement.SetHtmlContent (contai 
ner); 


} 


if (IncludeFooter) { 
output .PostElement.SetHtmlContent(conta 





aan Se BIE A ee Al title Js MEW divat z, 
访 div 元 素 使 用 PreElement 和 PostElement 属 性 来 添加 
TK ATA lc WIA Sean Hh CR © 





当 生 成 新 的 HTML 元 素 时 ， 可 以 使 用 标准 的 C# 
字符 串 格 式 来 创建 输出 内 容 ， 但 除非 用 于 最 简单 的 
元 素 ， 侣 则 这 是 一 种 案 拙 且 吻 钳 的 方式 。 更 稳健 的 
方式 是 使 用 TagBuilder 类 ， 它 定义 在 命名 空间 
Microsoft. AspNetCore.Mvc.Rendering 中 ， 访 类 文 持 
以 更 结构 化 的 方式 创建 元 素 。TagHelperContent 类 
定义 了 接收 TagBuilder 对 象 的 方法 ， 使 得 在 标签 助 




















手中 更 易于 创建 HIML 内容。 


这 个 标签 助手 使 用 TagBuilder 类 来 创建 h1 元 
素 ， 其 包含 在 使 用 Bootstrap 类 修饰 的 div 元 系 内 。 可 
选 的 bool 类 型 的 include-header 与 include-footer 属 性 
用 于 指定 内 容 插 入 何 处 ， 默 认 行 为 是 在 输出 元 素 之 
前 和 之 后 添加 元 素 。 代 码 清单 23-21 更 新 了 共享 布 
局 ， 以 便 包 含 一 个 将 被 标签 助手 转换 的 元 又 。 











代码 清单 23-21 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 使 用 标签 助手 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 


<title>Cities</title> 
<link href="/lib/bootstrap/dist/css/bootstrap.css" 


rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
<div title="Cities">@RenderBody()</div> 
</body> 
</html> 





如 果 运 行 应 用 程序 ， 你 将 会 看 标签 助手 被 应 用 
到 应 用 程序 中 ， 还 在 所 有 页 面 中 添加 了 页 凑 和 页 
脚 ， 如 图 23-5 所 示 。 














图 23-5 ”使 用 标签 助手 插入 HIML 元 素 
2. EMH ICR PHAN A 


PreContent 和 PostContent 属 性 用 于 在 输出 元 素 
内 环绕 源 内 容 插 入 内 容 。 为 了 演示 ， 在 
Infrastructure/TagHelpers 3¢ 43% P IIA WN 
TableCellTagHelper.cs 的 类 文件 ， 并 用 它 定 义 代 码 


清单 23-22 所 示 的 类 。 


代码 清单 23-22 Infrastructure/TagHelpers 文 件 夹 下 的 
TableCellTagHelper.cs 文 件 的 内 容 


using Microsoft.AspNetCore. Razor. TagHelpers; 
namespace Cities.Infrastructure.TagHelpers { 


[HtmlTargetElement("td", Attributes = "wrap") ] 
public class TableCellTagHelper : TagHelper { 


public override void Process(TagHelperContext c 
ontext, 
TagHelperOutput ou 


tput) { 


output.PreContent.SetHtmlContent("<b><i>"); 
output.PostContent.SetHtmlContent("</i></b> 





该 标签 助手 处 理 拥 有 wrap 属性 的 td 元 素 ， 插 入 
b 和 i 元 素 以 环绕 输出 元 素 的 内 容 。 代 码 清单 23-23 为 
Index.cshtml 视 图 文件 中 的 单元 格 深 加 了 wrap 属性 。 





代码 清单 23-23 ”在 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 中 
添加 HTML 属性 


@model IEnumerable<City> 


@{ Layout = " Layout"; } 


<table class="table table-sm table-bordered"> 
<thead class="bg-primary text-white"> 
<tr> 
<th>Name</th> 
<th>Country</th> 
<th class="text-right">Population</th> 
</tr> 
</thead> 
<tbody> 
@foreach (var city in Model) { 
<tr> 
<td wrap>@city.Name</td> 
<td>@city.Country</td> 
<td class="text-right">@city.Population 
?. TOString ("#, ###")</td> 
</tr> 


</tbody> 
</table> 
<a href="/Home/Create" class="btn btn-primary">Create</ 


a> 
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本 。 检 查 发 送 到 浏览 器 的 HTML 内 容 ， 你 将 会 看 到 
如 何 通 过 PreContent 与 PostContent 属 性 在 源 内 容 的 
前 后 添加 内 容 ， 如 下 所 示 : 

<tr> 


<td wrap><b><i>London</i></b></td> 
<td>UK</td> 


<td class="text-right">8,539,00@0</td> 
</tr> 





人 


提 ” 示 





wrap 属性 你 留 在 输出 元 系 中 。 这 是 因为 没有 在 
标签 助手 类 中 定义 这 个 属性 的 相关 属性 。 如 果 希 望 
了 咀 止 属性 包含 在 输出 中 ， 可 以 在 标签 助手 类 中 为 它 
们 定义 属性 ， 即 使 不 需要 属性 的 值 。 





23.3.3 ”使 用 依 顿 注入 获取 视图 上 下 文 数 据 


标 丛 助手 的 一 种 第 见 用 法 是 转换 元 素 以 便 包 含 
当前 请 求 或 当前 视图 模型 的 详细 内 容 。 作 为 示例 ， 
在 Infrastructure/TagHelpers 文 件 夹 中 添加 名 为 
FormTagHelper.cs 的 类 文件 ， 并 用 代码 清单 23-24 所 
示 的 内 容 定 义 此 关 。 





代码 清单 23-24 Infrastructure/TagHelpers 文 件 严 下 的 
FormTagHelper.cs 文 件 的 内 容 





using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore.Mvc.Rendering; 
using Microsoft.AspNetCore.Mvc.Routing; 
using Microsoft.AspNetCore.Mvc.ViewFeatures; 
using Microsoft.AspNetCore.Razor.TagHelpers; 


namespace Cities.Infrastructure.TagHelpers { 


public class FormTagHelper : TagHelper { 
private IUrlHelperFactory urlHelperFactory; 


public FormTagHelper(IUrlHelperFactory factory) 


urlHelperFactory = factory; 
} 


[ViewContext] 
[HtmlAttributeNotBound ] 
public ViewContext ViewContextData { get; set; 


public string Controller { get; set; } 
public string Action { get; set; } 


public override void Process(TagHelperContext c 

ontext, 
TagHelperOutput ou 

tput) { 


IUrlHelper urlHelper = urlHelperFactory.Get 
UrlHelper(ViewContextData) ; 


output.Attributes.SetAttribute("action", ur 
lHelper.Action( 
Action ?? 
ViewContextData.RouteData.Values["a 
ction"].ToString(), 
Controller ?? 
ViewContextData.RouteData.Values[ "contr 
oller"].ToString())); 


} 


} 





顾名思义 ，FormTagHelper 类 人 处理 form 元 素 ， 
设置 action 属 性 以 指定 将 表单 数据 发 送 到 何方 。 如 





果 form 元 素 拥 有 controller 和 action 属 性 ， 它 们 的 属性 
值 将 用 于 生成 目标 URL; FU, KAEH K K E H žr 
据 的 controller 和 action 值 。 





为 了 获取 上 下 文 数据 ， 添 加 名 为 
ViewContextData 的 属性 ， 并 使 用 两 个 特性 进行 修 
饰 ， 如 下 所 示 : 


[ ViewContext ] 
[HtmlAttributeNotBound ] 


public ViewContext ViewContextData { get; set; } 





ViewContext 特 性 表示 当 创 建 FormTagHelper 类 
的 实例 时 ， 应 该 为 相应 的 属性 分 配 ViewContext 对 
象 ， 如 第 18 半 所 示 。ViewContext 类 提供 了 正在 泻 
染 的 视图 的 详情 、 足 由 数据 以 及 当前 的 HTTP 请 
求 ， 见 第 21 章 。 


如 果 HTML 元 素 input 拥 有 view-context 属 性 ， 那 


么 HtmlAttributeNotBound 特 性 可 防止 MVC 给 该 属性 
赋值 。 这 种 做 法 很 好 ， 特 别 是 在 开 友 其 他 开发 者 使 
用 的 标签 助手 时 。 


人 
提 示 


内 置 的 用 于 表单 的 标签 助手 类 可 用 于 设 定 操 作 
方法 ， 并 用 于 实际 项 目 中 。 本 书 中 的 HTML helper 
仅 用 于 演示 上 下 文 数据 是 如 何 使 用 的 。 请 合 看 第 24 
章 以 了 解 内 置 标签 助手 的 详情 。 








标签 助手 可 以 在 构造 函数 中 定义 作为 服务 的 依 
赖 项 ， 它 们 将 使 用 依赖 注入 特性 进行 解析 。 在 本 例 


中 ， 定 义 用 于 IUrlHelperFactory 服 务 的 依赖 ， 以 允 
许 从 路 由 数据 创建 传 出 的 URL。 在 Process 方 法 中 ， 
标签 助手 使 用 IUrlHelperFactory.GetUrlHelper 方 法 来 
获取 使 用 ViewContext 对 象 配置 的 IUrlHelper 对 象 ， 
为 输出 元 系 的 action 属 性 创建 URL。 代 但 清单 23-25 
展示 了 准备 的 视图 ， 这 里 移 除了 action 属 性 ， 以 便 
使 用 标签 助手 来 设置 。 








代码 清单 23-25 ”在 Create.cshtml 文 件 中 删除 表单 元 素 的 属性 





@model City 


@{ Layout = " Layout"; } 


<form method="post"> 
<div class="form-group"> 
<label for="Name">Name:</label> 
<input class="form-control" name="Name" /> 
</div> 
<div class="form-group"> 
<label for="Country">Country:</label> 
<input class="form-control" name="Country" /> 
</div> 
<div class="form-group"> 
<label for="Population">Population:</label> 
<input class="form-control" name="Population" / 


</div> 
<formbutton type="submit" bg-color="danger" /> 
<formbutton type="reset" /> 
<a bs-button-color="primary" href="/Home/Index">Can 
cel</a> 
</form> 





如 果 运 行 应 用 程序 并 访问 /Home/Create， 然 后 
检查 友 送 到 浏览 器 的 HITML， 你 将 会 看 到 form 元 素 
拥有 action 属 性 ， 其 值 可 使 用 上 下 文 数据 来 设置 ， 
如 下 所 未 : 


<form method="post" action="/Home/Create"> 





23.3.4 ”使 用 视图 模型 


标签 助手 还 可 以 处 理 视图 模型 ， 祖 一 执行 的 转 
换 与 创建 的 输出 。 为 了 进行 演示 ， 在 Infrastructure/ 
TagHelpers 文 件 夹 中 创建 名 为 
LabelAndInputTagHelper.cs 的 类 文件 ， 并 使 用 代码 
清早 23-26 所 示 内 容 定 义 此 类 。 








代码 清单 23-26 Infrastructure/TagHelpers 文 件 夹 下 的 
LabelAndInputTagHelper.cs 文 件 的 内 容 





using Microsoft.AspNetCore.Mvc.ViewFeatures; 
using Microsoft.AspNetCore.Razor.TagHelpers; 


namespace Cities.Infrastructure.TagHelpers { 


[HtmlTargetElement("label", Attributes 
r")] 

[HtmlTargetElement("input", Attributes 
r")] 

public class LabelAndInputTagHelper : TagHelper { 


"helper-fo 


"helper-fo 


public ModelExpression HelperFor { get; set; } 
public override void Process(TagHelperContext c 
ontext, 
TagHelperOutput ou 
tput) { 


if (output.TagName == "label") { 
output.TagMode = TagMode.StartTagAndEnd 


Tag; 
output.Content.Append(HelperFor.Name) ; 
output .Attributes.SetAttribute("for", H 
elperFor.Name) ; 


} else if (output.TagName == "input") { 
output.TagMode = TagMode.SelfClosing; 
output .Attributes.SetAttribute("name", 

HelperFor.Name) ; 
output .Attributes.SetAttribute("class", 

"form-control") ; 
if (HelperFor.Metadata.ModelType == typ 


eof(int?)) { 
output.Attributes.SetAttribute("typ 


e", "number") ; 





该 标签 助手 转换 拥有 helper-for 属 性 的 label 与 
input 元 妇 。 该 标签 助手 的 重要 之 处 在 于 HelperFor 属 
性 的 类 型 ， 该 属性 用 于 接收 helperfor 属 性 的 值 。 


public ModelExpression HelperFor { get; set; } 


当 和 希望 对 视图 模型 的 一 部 分 进行 处 理 时 ， 将 使 
用 ModelExpression 类 。 最 简单 的 方式 是 跳 过 说 明 ， 
如 代码 清单 23-27 所 示 ， 展 示 标 和 俭 助手 是 如 何 应 用 
于 视图 的 。 











代码 清单 23-27 在 Views/Home 文 件 夹 下 的 Create.cshtml 文 件 中 
应 用 标签 助手 处 理 模型 





@model Cities.Models.City 


@{ Layout = " Layout"; } 


<form method="post"> 
<div class="form-group"> 
<label helper-for="Name" /> 
<input helper-for="Name" /> 
</div> 
<div class="form-group"> 
<label helper-for="Country" /> 
<input helper-for="Country" /> 
</div> 
<div class="form-group"> 
<label helper-for="Population"/> 
<input helper-for="Population" /> 
</div> 
<formbutton type="submit" bg-color="danger" /> 
<formbutton type="reset" /> 
<a bs-button-color="primary" href="/Home/Index">Can 
cel</a> 
</form> 





helper-for 属 性 的 值 来 目 Model 类 ， 该 类 由 MVC 
检测 并 作为 ModelExpression 对 象 提 供给 标签 助手 。 


本 节 不 会 深入 说 明 ModelExpression 类 ， 因 为 对 
类 型 执行 的 任何 检查 都 会 寻 致 无 尽 的 类 和 属性 列 
表 。 此 外 ，MVC 附 禹 了 一 组 有 用 的 内 置 标签 助手 ， 





可 使 用 视 几 个 型 来 转换 元 素 ， 如 第 24 章 所 述 ， 这 意 
味 看 不 必 目 己 创建 。 





对 于 标签 助手 ， 这 里 使 用 了 两 个 值得 说 明 的 基 
本 特性 。 第 一 个 特性 是 获取 模型 属性 的 名 称 ， 以 便 
可 以 包含 在 输出 元 系 中 ， 如 下 所 示 : 





output .Content .Append(HelLperFor .Name ) ; 





output.Attributes.SetAttribute("for", HelperFor.Name) ) ; 


Name 属 性 返回 模型 属性 的 名 称 。 


第 二 个 特性 是 获取 模型 属性 的 类 型 ， 以 便 可 以 
改变 input 元 素 的 type 属 性 ， 如 下 所 示 : 


if (HelLperFor .Metadata.ModelType == typeof(int?)) { 
output .Attributes.SetAttribute("type", "number"); 





} 


如 果 执 行 应 用 程序 并 访问 /Home/Create， 然 后 


检查 发 送 到 浏览 器 的 HTML 内容 ， 你 将 会 看 到 如 下 
TUR: 


<div class="form-group"> 

<label for="Name">Name</label> 

<input name="Name" class="form-control" /> 
</div> 
<div class="form-group"> 

<label for="Country">Country</label> 


<input name="Country" class="form-control" /> 
</div> 
<div class="form-group"> 

<label for="Population">Population</label> 

<input name="Population" class="form-control" type= 
"number" /> 
</div> 





以 上 代码 把 用 于 input 元 素 Population 的 type 属 性 
设置 为 mqmber， 以 有 反映 City.Population 属 性 在 C# 类 
中 为 ipt 类型。 本 节 展 示 了 标签 助手 如 何 反 映 不 同 的 
模型 特征 来 生成 HIML 。 基 于 使 用 的 浏览 器 ，input 
元 素 将 只 人 允许 输入 数字 。 








23.3.5 ”协调 标签 助手 


TagHelperContext.Items 属 性 提供 了 一 个 字典 ， 
用 于 在 操作 元 素 的 标签 助手 与 后 继 操 作 元 素 的 标签 
助手 之 间 进 行 协 调 。 为 了 演示 Items 集 合 的 用 法 ， 在 
Infrastructure/TagHelpers 3¢ 43% P AIA WN 
CoordinatingTagHelpers.cs 的 类 文件 ， 在 其 中 使 用 代 


码 清单 23-28 所 示 的 内 容 定 义 一 对 标签 助手 。 














代码 清单 23-28 Infrastructure/TagHelpers 文 件 夹 下 的 
CoordinatingTagHelpers.cs 文 件 的 内 容 





using Microsoft.AspNetCore.Razor.TagHelpers; 


namespace Cities.Infrastructure.TagHelpers { 


[HtmlTargetElement("div", Attributes = "theme") | 
public class ButtonGroupThemeTagHelper : TagHelper 


public string Theme { get; set; } 


public override void Process(TagHelperContext c 
ontext, 


TagHelperOutput ou 
tput) { 
context.Items["theme"] = Theme; 


[HtmlTargetElement("button", ParentTag = "div") | 
[HtmlTargetElement("a", ParentTag = "div") | 
public class ButtonThemeTagHelper : TagHelper { 


public override void Process(TagHelperContext c 
ontext, 


TagHelperOutput ou 
tput) { 


if (context.Items.ContainsKey("theme")) { 
output .Attributes.SetAttribute("class", 
$"btn btn-{context.Items[ "theme" ]}" 





第 一 个 标签 助手 是 
ButtonGroupThemeTagHelper 类 ， 用 于 处 理 拥有 
theme 属 性 的 div 元 素 。 协 调 标签 助手 可 以 转换 目 己 
的 元 系 ， 但 是 这 个 示例 只 是 向 单 地 这 加 theme 属 性 
的 值 到 Items 字 典 ， 以 便 包 售 在 div 元 素 内 的 标签 助 
手 可 以 使 用 。 


第 二 个 标签 助手 是 ButtonThemeTagHelper 类 ， 


用 于 处 理 拥有 a 元 素 和 button 元 素 的 div 元 素 ， 并 使 用 
来 自 Items 字 典 的 theme 属 性 值 来 设置 输出 元 系 的 
Bootstrap 样 式 。 代 码 清单 23-29 展 示 了 这 些 标签 助手 
应 用 的 元 系 集 合 。 


代码 清单 23-29 ”在 Views/Home 文 件 夹 下 的 Create.cshtml 文 件 中 
应 用 协调 标签 助手 





@model Cities.Models.City 


@{ Layout = " Layout"; } 


<form method="post"> 
<div class="form-group"> 
<label helper-for="Name" /> 
<input helper-for="Name" /> 
</div> 
<div class="form-group"> 
<label helper-for="Country" /> 
<input helper-for="Country" /> 
</div> 
<div class="form-group"> 
<label helper-for="Population" /> 
<input helper-for="Population" /> 
</div> 
<div theme="primary"> 
<button type="submit" >Add</button> 
<button type="reset" >Reset</button> 
<a href="/Home/Index">Cancel</a> 


</divy 
</form> 

如 果 运 行 应 用 程序 并 访问 /Home/Create， 你 将 
会 看 到 按钮 组 都 以 同样 的 方式 修饰 。 如 果 修 改 div 元 
素 的 theme 属 性 为 其 他 的 Bootstrap 主 题 设置 ， 例 如 
info、danger 或 primary， 并 重新 加 载 页 面 ， 你 将 会 
看 到 修改 已 反映 到 按钮 上 ， 如 图 23-6 所 示 。 


CE0 ALEEA 
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图 23-6 ”协调 标签 助手 
23.3.6 ”抑制 输出 元 素 


通过 在 使 用 Process 方 法 的 参数 接收 的 
TagHelperOutput 对 象 上 调用 SuppressOuput 方 法 ， 标 
丛 助 手 可 以 用 于 防止 元 素 被 包含 在 输出 到 浏览 器 的 
HTML 中 。 代 码 清单 23-30 在 共享 布局 中 添加 了 一 个 





元 素来 显示 高 亮 信 息 ， 但 是 这 里 仅仅 对 于 特定 的 请 
求 方式 才 显 示 。 





代码 清单 23-30 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 添加 可 视 信 息 


<!DOCTYPE html> 
<html> 
<head> 

<meta name="viewport" content="width=device-width" 
/> 

<title>Cities</title> 

<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 
</head> 


<body class="m-1 p-1"> 
<div show-for-action="Index" class="m-1 p-1 bg-dang 
er"> 


<h2>Important Message</h2> 
</div> 
<div title="Cities">@RenderBody()</div> 
</body> 
</html> 





show-for-action 属 性 指定 了 和 希望 显示 警告 信息 
的 操作 方法 的 名 称 。 这 不 是 在 实际 应 用 程序 中 控制 
包含 内 容 的 有 用 方式 ， 但 是 对 于 仅 有 一 个 控制 器 和 














两 个 操作 方法 名 称 的 示例 应 用 来 说 是 有 效 的 。 代 码 
清单 23-31 展 示 了 SelectiveTagHelper.cs 类 的 内 容 ， 
将 它 添 加 到 Infrastructure/TagHelpers 文 件 夹 中 。 


代码 清单 23-31 Infrastructure/TagHelpers 文 件 夹 下 的 
SelectiveTagHelper.cs 文 件 的 内 容 





using System; 

using Microsoft.AspNetCore.Mvc.Rendering; 
using Microsoft.AspNetCore.Mvc.ViewFeatures; 
using Microsoft.AspNetCore. Razor. TagHelpers; 


namespace Cities.Infrastructure.TagHelpers { 


[HtmlTargetElement(Attributes = "show-for-action") ] 
public class SelectiveTagHelper : TagHelper { 


public string ShowForAction { get; set; } 


[ViewContext | 
[HtmlAttributeNotBound | 
public ViewContext ViewContext { get; set; } 
public override void Process(TagHelperContext c 
ontext, 
TagHelperOutput ou 


tput) { 


if (!ViewContext.RouteData.Values[ "action" | 
. ToString() 
.Equals(ShowForAction, StringCompar 


ison.OrdinalIgnoreCase)) { 
output .SuppressOutput() ; 





这 个 标签 助手 使 用 ViewContext 从 路 由 数据 中 
获取 action 值 ， 然 后 与 HIML 元 素 的 show-for-action 
属性 做 比较 。 如 条 它们 不 匹配 ， 则 SuppressOutpnut 
方法 锌 调用。 为 但 看 效果 ， 局 动 应 用 程序 并 访 
问 /Home/Index 和 /Home/Create。 如 图 23-7 所 示 ， 信 
息 仅 仅 在 Index 这 个 操作 方法 被 调用 时 显示 。 











图 23-7 ”使 用 标签 助手 抑制 元 素 


23.4 小结 


本 半 介 绍 了 标签 助手 的 用 法 ， 标 签 助 手 是 


ASP.NET Core MVC 的 新 增 特 性 。 本 章 还 介绍 了 标 
签 助手 在 Razor 视 图 中 的 角色 ， 并 演示 了 上 自 定义 标 
签 助 手 是 如 何 创建 、 注 册 并 应 用 的 。 本 章 接 下 来 展 
示 了 如 何 控制 标签 助手 的 作用 域 ， 并 说 明了 使 用 标 
签 助 手 转换 HTML 元 素 的 各 种 不 同方 式 。 下 一 章 将 
说 明 标 签 助手 在 HTML 表 单元 素 中 的 使 用 。 
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MVC 提 供 了 一 套 内 置 的 标签 助手 来 执行 日 总 
必需 的 HTML 转换。 本章 介 绍 操作 HIML 和 表单 的 标 
签 助手 ，HTML 表 单 往往 包括 form、input、label、 
select、option 和 textarea 元 素 。 第 25 章 将 介绍 其 他 内 
置 的 标 丛 助 手 ， 它 们 提供 非 表 单元 际 的 特性 。 表 
24-1 介 绍 了 表单 标签 助手 的 背景 。 











表 24-1 表单 标签 助手 的 背景 



























































表单 标签 助手 用 于 转换 HTML 表 单元 素 ， 从 而 不 必 编 写 自 定义 的 标签 助手 就 可 以 











理 常见 的 多 数 问 题 











表单 标 ”| 表单 标签 助手 确保 HTML 表 单元 素 〈 包 括 在 表单 内 的 元 素 ， 比 如 label 和 input 元 
SWF |R) 被 一 致 地 生成 。 大 部 分 情况 下 ， 标 签 助手 确保 重要 的 属性 〈 如 id、name 和 
有 何 作 |for) 已 使 用 视图 模型 类 正确 设置 ， 但 是 有 些 标 签 助手 也 可 以 生成 内 容 ， 例 如 填 
FA? 充 select 元 素 中 的 option 子 元 素 

































































使 用 内 置 的 标签 助手 查询 带 有 asp- 前 级 的 属性 ， 比 如 asp-for 属 性 























仅 有 的 限制 是 提供 给 标签 助手 的 用 以 生成 select 元 素 中 option 子 元 素 的 模型 数据 的 
方式 。24.5 节 将 介绍 这 个 问题 ， 并 提供 自 定义 的 标签 助手 来 处 理 















































可 以 不 使 用 这 些 标签 助手 在 视图 中 编写 HTML 表 单 ， 也 可 以 使 用 第 23 章 介 乡 
术 ， 开 发 自己 的 标签 助手 

















表 24-2 列 出 了 本 章 要 介绍 的 操作 。 


表 24-2 ”本章 要 介绍 的 操作 








为 form 元 素 设 置 action 
属性 














使 用 form 元 素 标签 助手 














防止 跨 站 请 求 伪造 
(cross-site request 为 操作 方法 应 用 ValidateAntiForgeryToken 特 性 ， | 代码 清单 24-6 和 





























forgery ) 














input 元 素 的 id、 
name 和 value 属 性 






































修改 应 用 asp-for 属 性 的 
label 元 素 的 内 容 





为 select 元 素 设 置 id 和 
name 属 性 


生成 option 元 素 


为 textarea 元 素 设置 id 和 
name 属 性 


| 应 用 asp-for 属 性 


在 表单 元 素 上 设置 asp-antiforgery 属 性 (可 选 ) 











应 用 asp-for 属 性 


为 input 元 素 应 用 asp-format 属 性 ， 或 者 在 模型 类 
上 应 用 DisplayFormat 特 性 


















































在 模型 类 上 应 用 Display 特 性 ， 且 使 用 Name 属 性 
指定 内 容 

















应 用 asp-for 属 性 





应 用 asp-items 属 性 








应 用 asp-for 属 性 








24.1 ”人 准备 示例 项 上 日 





代码 清单 24-7 








代码 清单 24-8 











代码 清单 24-9 一 
代码 清单 24-12 











代码 清单 24-13 








代码 清单 24-14 











代码 清单 24-15 














代码 清单 24-16 
一 代码 清单 24- 
21 






































代码 清单 24-22 
和 代码 清单 24- 
23 



































本 章 继续 使 用 第 23 章 创建 的 Cities 项 目 。 对 于 
本 章 ， 需 要 启用 来 自 MVC 的 内 置 标签 助手 ， 并 禁 
第 23 草 创建 的 目 定 义 标签 助手 。 代 码 清单 24-1 展 示 
了 在 视图 导入 文件 中 所 做 的 变更 ， 这 里 使 用 MVC 的 
标签 助手 替换 了 @addTagHelper 在 Cities 程 序 集 中 的 
标签 助手 ， 定 义 在 命名 空间 
Microsoft.AspNetCore.Mvc.TagHelpers 中 。 











代码 清单 24-1 修改 View 文 件 来 下 的 _ViewImports.cshtml 文 件 
中 的 标签 助手 


@using Cities.Models 
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 
E BM EA A J 


代码 清单 24-2 展 示 了 Index.cshtml 文 件 的 内 容 ， 
这 里 移 除 了 使 用 目 定义 标签 助手 类 的 属性 。 


代码 清单 24-2 ”Views/Home 文 件 夹 下 的 Index.cshtml 文 件 中 的 


@model IEnumerable<City> 
@{ Layout = " Layout"; } 


<table class="table table-sm table-bordered"> 
<thead class="bg-primary text-white"> 
<tr> 
<th>Name</th> 
<th>Country</th> 
<th class="text-right">Population</th> 
</tr> 
</thead> 
<tbody> 
@foreach (var city in Model) { 
<tr> 
<td>@city .Name</td> 
<td>@city.Country</td> 
<td class="text-right">@city.Population 
?. ToString ("#, ###")</td> 
</tr> 


} 
</tbody> 
</table> 
<a href="/Home/Create" class="btn btn-primary">Create</ 


a> 





代码 清单 24-3 展 示 了 对 Create.cshtml 文 件 所 做 
的 相关 修改 ， 这 里 回 到 了 标准 的 HIML 元 素 ， 而 没 
有 使 用 第 23 章 介绍 的 属性 。 





代码 清单 24-3 ”Views/Home 文 件 夹 下 的 Create.cshtml 文 件 的 内 


P 


谷 


@model City 


@{ Layout = " Layout"; } 


<form method="post" action="/Home/Create" > 
<div class="form-group"> 
<label for="Name">Name:</label> 
<input class="form-control" name="Name" /> 
</div> 
<div class="form-group"> 
<label for="Country">Country:</label> 
<input class="form-control" name="Country" /> 
</div> 
<div class="form-group"> 
<label for="Population">Population:</label> 
<input class="form-control" name="Population" / 


</div> 

<button type="submit" class="btn btn-primary">Add</ 
button> 

<a class="btn btn-primary" href="/Home/Index">Cance 
l</a> 
</form> 





最 后 修改 共有 日 布 局， 如 代码 清单 24-4 所 示 。 


代码 清单 24-4 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 件 的 
内 容 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 


<title>Cities</title> 
<link href="/lib/bootstrap/dist/css/bootstrap.css" 


rel="stylesheet" /> 

</head> 

<body class="m-1 p-1"> 
<div>@RenderBody()</div> 

</body> 

</html> 





如 果 运 行 应 用 程序 ， 你 将 会 看 到 城市 列表 ， 可 
以 单 击 Create 按 钮 ， 填 充 表 单 后 提交 新 的 数据 给 服 
务 器 ， 如 图 24-1 所 示 。 


€ C | © localhost ir e C IO 个 
| eo Country eects || Name 

London UK 8,539,000 

New York USA 406,01 

San Jose USA 998,53 

Paris France 2,244,001 
| 





图 24-1 ”运行 示例 应 用 


24.2 ”使 用 form 元 素 


FormTagHelper 类 是 form 元 素 的 内 置 标签 助 
手 ， 用 于 管理 HTML 表 单 的 配置 以 便 基 于 应 用 程序 
的 路 由 配置 指 癌 正确 的 操作 方法 。 该 标签 助手 文 持 
表 24-3 所 示 的 属性 























表 24-3 form 元 系 的 内 置 标 签 助 手 类 定义 的 属性 





























用 于 指定 action 属 性 URL 对 应 的 路 由 系统 的 controller 值 。 如 果 和 忽略 ， 将 使 月 
controller | 现 视 图 的 控制 器 


用 于 指定 action 属 性 URL 对 应 的 路 由 系统 的 action 值 。 如 果 和 忽略 ， 呈 现 视 图 世 
asp-action ees 
action 将 会 被 使 用 












































































































































asp-route- | 以 asp-route- 开 头 的 属性 名 用 于 指定 action 属 性 URL 的 附加 值 ， 所 以 asp-route-id 
$ 盟 性 用 来 为 路 由 系统 提供 id 片段 的 值 


























于 指定 生成 action 属 性 URL 的 路 由 
用 于 生成 action 属 性 URL 的 area 名 称 


控制 是 否 为 视图 添加 anti-forgery 信 息 
































24.2.1 设置 form 目 标 











FormTagHelper 类 的 主要 目的 是 使 用 应 用 程序 
的 路 由 配置 来 设置 form 元 素 的 action 属 性 ， 确 保 即 
使 路 由 架构 发 生 了 变化 ， 表 单数 据 也 总 是 被 发 送 到 
正确 的 URL 地 址 。 代 码 清单 24-5 使 用 asp-action 和 
asp-controller)& VE #4 [a] Homes fill 44 HY Create et /F 
Ie 





v> DA 
E Je 


标签 助手 并 不 设置 method 属 性 ， 如 果 在 form 元 
系 中 忽略 该 属性 ， 那 么 浏览 右 将 会 使 用 GET 请 求 来 
有 发送 表单 数据 。 如 第 17 章 所 述 ， 如 条 表单 数据 用 于 
修改 应 用 程序 中 的 数据 ， 这 可 能 导致 问题 。 最 佳 实 





践 是 设置 method 属 性 ， 尤 其 当 希 望 使 用 GET 请 求 
上 时， 显然 不 能 态 了 设置 method 属 性 为 GET。 


代码 清单 24-5 ”设置 Views/Home 文 件 夹 下 的 Create.cshtml 文 件 
中 的 form 目 标 





@model City 


@{ Layout = " Layout"; } 


<form method="post" asp-controller="Home" asp-action="C 
reate"> 
<div class="form-group"> 
<label for="Name">Name:</label> 
<input class="form-control" name="Name" /> 
</div> 
<div class="form-group"> 
<label for="Country">Country:</label> 
<input class="form-control" name="Country" /> 
</div> 
<div class="form-group"> 
<label for="Population">Population:</label> 
<input class="form-control" name="Population" / 


</div> 


<button type="submit" class="btn btn-primary">Add</ 
button> 


<a class="btn btn-primary" href="/Home/Index">Cance 


如 果 运 行 应 用 程序 ， 访 问 /Home/Create 并 检查 
发 送 到 客户 问 的 HTML， 你 将 会 看 到 标签 助手 已 添 
加 action 属 性 到 form 元 系 中 并 使 用 路 由 系统 设置 了 
值 ， 如 下 所 示 : 








24.2.2 ”使 用 防伪 特性 


跨 站 请 求 伪造 (Cross-Site Request Forgery, 
CSRF) 是 一 种 利用 用 户 请 求 验 证 来 攻击 web 应 用 
程序 的 方式 。 大 多 数 Web 应 用 程序 (包括 使 用 
ASP.NET Core 创 建 的 ) 使 用 Cookie 来 标识 哪些 请 求 
与 特定 会 话 相 关 ， 用 户 标 识 通 常 与 之 相关 。 


CSRF (也 称 为 会 话 劫持) 的 详细 说 明 参 见 维 
基 百 科 ， 基 于 用 户 在 使 用 应 用 程序 ， 但 是 没有 通过 





单 击 Logout 按 钮 显 式 结束 会 话 之 后 访问 恶意 站 点 ， 
应 用 程序 仍然 将 用 户 会 话 视 为 活动 的 ， 存 储 在 浏览 
器 中 的 Cookie 仍 没有 过 期 。 和 恶意 站 点 包含 JavaScript 
代码 ， 它 回应 用 程序 发 送 表单 请 求 ， 在 未 经 用 户 同 
意 的 情况 下 执行 操作 ， 操 作 的 性 质 取决 于 被 攻击 的 
应 用 程序 。 由 于 JavaScript 代 码 在 用 户 浏览 器 中 执 
行 ， 因 此 同 应 用 程序 发 出 的 请 求 包含 会 话 的 Cookie 
值 ， 而 应 用 程序 会 在 用 户 不 知情 或 不 同意 的 情况 下 
执行 操作 。 











如 果 form 元 素 没 有 包含 action 属 性 (因为 是 路 
由 系统 使 用 asp-controller 和 asp-acton 属 性 生成 
的 ) ， 那 么 FormTagHelper 类 将 自动 局 用 反 CSRF 特 
性 ， 将 安全 令 牌 包含 在 表单 的 一 个 hidden 类 型 的 
input 元 素 中 ， 并 同 Cookie 一 起 发 送 到 客户 端 。 应 用 
程序 将 仪 仪 处 理 同时 包含 Cookie 和 来 自 表 单 隐藏 域 
的 值 的 请 求 ， 和 恶意 站 点 不 能 访问 。 表 单 生 成 鸭 每 个 








请 求 都 有 新 的 唯一 安全 令 牌 。 


如 果 运 行 应 用 程序 ， 访 问 /Home/Create 并 查看 
发 送 到 浏览 器 的 HTML， 你 将 会 看 到 input 隐 藏 域 ， 
如 下 所 示 : 


<input name="__RequestVerificationToken" type="hidden" 
value="CfDI8KUVKH8hF 1RApe 
FBxTrhCFTKZe@B9BKwnWDIJqQLRUDk__PrEwaeCJmiBbGkwW1Z181 


6c_TrM5XQkJBeqNI5SIL8FhuO 
RvjZuYIL-GZvnWZ620ThsZYT@2HNX_LUSLWDNWDdVoS5O5hZtza 
OHLeYS51Nto" /> 





如 果 投 F12 键 ， 束 可 以 看 到 相关 的 添加 到 回应 
中 的 Cookie。 将 安全 令 牌 添加 到 HIML 啊 应 中 仅仅 
是 处 理 的 一 部 分 ， 还 必须 在 控制 器 中 进行 验证 ， 如 
代码 清单 24-6 所 示 。 


代码 清单 24-6 ”在 Colltrollers 文 件 夹 下 的 HomeController.cs 中 验 
证 anti-forgery 令 牌 


using Microsoft.AspNetCore.Mvc; 
using Cities.Models; 


namespace Cities.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 

} 

public ViewResult Index() => View(repository.Ci 


ties); 


public ViewResult Create() => View(); 


[HttpPost ] 

[ValidateAntiForgeryToken] 

public IActionResult Create(City city) { 
repository .AddCity(city); 
return RedirectToAction("Index") ; 





ValidateAntoForgeryToken 特 性 确保 请 求 中 包含 
有 效 的 反 CSREF 令 牌 ， 如 果 不 存 在 或 者 没有 包含 期 
望 的 值 ， 将 会 抛 出 异常 。 


FormTagHelper 类 提供 了 asp-antiforgery 属 性 来 
复写 默认 的 反 CSRF 行 为 。 如 果 访 属性 的 值 为 true， 








安全 令 牌 将 被 包含 到 啊 应 中 ， 即 使 form 元 系 拥 有 
action 必 性。 如 条 该 属性 的 值 为 false， 安 全 令 牌 将 
锌 禁用。 代码 清单 24-7 显 式 启 用 了 该 属性 ， 因 为 没 
有 在 form 元 素 中 定义 action 属 性 ， 所 以 无 论 如 何 都 
将 添加 安全 令 牌 。 





代码 清单 24-7 在 Views/Home 文 件 夹 下 的 Create.cshtml 文 件 中 
启用 反 CSRF 特 性 





@model City 


@{ Layout = " Layout"; } 


<form method="post" asp-controller="Home" asp-action="C 
reate" 
asp-antiforgery="true"> 
<div class="form-group"> 
<label for="Name">Name:</label> 
<input class="form-control" name="Name" /> 
</div> 
<div class="form-group"> 
<label for="Country">Country:</label> 
<input class="form-control" name="Country" /> 
</div> 
<div class="form-group"> 
<label for="Population">Population:</label> 
<input class="form-control" name="Population" / 


</div> 

<button type="submit" class="btn btn-primary">Add</ 
button> 

<a class="btn btn-primary" href="/Home/Index">Cance 
l</a> 
</form> 





y 
提 示 


测试 反 CSRF 特 性 时 需要 一 点 技巧 。 首 先 让 请 
求 包含 表单 的 URL 地 址 (对 于 本 例 来 说 
是 /Home/Create) ， 然 后 使 用 F12 键 来 定位 并 删除 表 
时 中 的 input 隐 藏 域 。 当 填充 表单 后 发 送 回 应 用 程序 
时 ， 浏 览 恬 不 会 提供 请 求 的 数据 ， 请 求 将 会 失败 并 
展示 错误 页 面 。 





24.3 ”使 用 input 元 素 


input 元 素 是 HTML 表 单 的 核心 ， 它 们 提供 了 用 
户 可 以 将 非 结 构 化 数据 提供 给 应 用 程序 的 主要 方 
法 。InputTagHelper 关 用 于 转换 input 元 素 ， 它 们 反 
映 了 在 视图 模型 上 获取 的 数据 类 型 和 格式 ， 并 使 用 
表 24-4 所 示 的 属性 。 








4224-4 用 于 input 元 系 的 内 置 标 俭 助手 的 属性 



































于 指定 input 元 素 表 示 的 视图 模型 属性 











于 指定 input 元 素 表 示 的 视图 模型 属性 值 的 格式 








24.3.1 ”配置 input 元 素 


asp-for 属 性 被 设置 为 视图 模型 属性 的 名 称 ， 从 
而 用 于 设置 input 元 系 的 id、type 和 value 属 性 。 代 三 








清单 24-8 为 Create.cshtml 文 件 中 的 input 元 素 应 用 了 
asp-for 属 性 。 


代码 清单 24-8 ”在 Views/Home 文 件 夹 下 的 Create.cshtml 文 件 中 
配置 input 元 素 





@model City 


@{ Layout = " Layout"; } 


<form method="post" asp-controller="Home" asp-action="C 
reate" 
asp-antiforgery="true"> 
<div class="form-group"> 
<label for="Name">Name:</label> 
<input class="form-control" asp-for="Name" /> 
</div> 
<div class="form-group"> 
<label for="Country">Country:</label> 
<input class="form-control" asp-for="Country" /> 


</div> 
<div class="form-group"> 
<label for="Population">Population:</label> 
<input class="form-control" asp-for="Population 
" /> 
</div> 
<button type="submit" class="btn btn-primary">Add</ 
button> 


<a class="btn btn-primary" href="/Home/Index">Cance 
l</a> 


</form> 


如 果 运 行 应 用 程序 并 访问 /Home/Create， 你 将 
会 看 到 标签 助手 使 用 asp-for 属 性 来 定制 每 个 input 元 
素 ， 如 以 下 代码 所 示 〈( 急 略 了 反 CSRF 安 全 令 
WA): 








<form method="post" action="/Home/Create"> 
<div class="form-group"> 
<label for="Name">Name:</label> 
<input class="form-control" type="text" id="Nam 
name="Name" value="" /> 
</div> 
<div class="form-group"> 
<label for="Country">Country:</label> 
<input class="form-control" type="text" id="Cou 


e 


ntry" 
name="Country" value="" /> 
</div> 
<div class="form-group"> 
<label for="Population">Population:</label> 
<input class="form-control" type="number" id="P 
opulation" 
name="Population" value="" /> 
</div> 
<button type="submit" class="btn btn-primary">Add</ 
button> 
<a class="btn btn-primary" href="/Home/Index">Cance 
l</a> 
</form> 





input 元 系 的 type 属 性 指定 了 如 何在 表单 中 显示 
该 元 素 。 可 以 在 用 于 Population 属 性 的 input 元 素 中 
简单 地 看 到 结果 ， 其 type 属 性 已 经 设置 为 namber。 
因为 C# 的 Population 属 性 类 型 为 int?， 上 所 以 标签 助手 
使 用 type 属 性 来 指示 浏览 右 只 有 数字 才能 接受 。 


多 
注 意 


人 们 将 type 属 性 的 解释 方式 留 给 了 浏览 顷 。 并 
韭 所 有 的 浏览 器 都 响应 HTML5 规 范 中 定义 的 所 有 
类 型 ， 即 使 处 理 ， 它 们 的 实现 方式 也 存在 莽 异 。 
type 属 性 是 对 表单 中 所 需 数 据 类 型 的 有 效 握 示 ， 但 
是 你 应 该 使 用 模型 验证 特性 来 确保 用 户 提供 有 用 的 
数据 。 





表 24-5 说 明了 不 同 的 C# 属 性 类 型 和 它们 生成 的 
input 元 素 类 型 。 


表 24-5”C# 属 性 类 型 和 它们 生成 的 input 元 素 类 型 


生成 的 mput 元 素 类 型 
byte, sbyte, int. uint, short. ushort. 
number 
long. ulong 


text， 带 有 额外 的 用 于 模型 验证 的 属 
后 说 明 




















float、double、decimal 





类 型 float、double 和 decimal 能 生成 type 属 性 为 
text 的 input 元 素 ， 因 为 不 是 所 有 的 浏览 器 都 支持 可 





以 用 于 这 些 类 型 的 全 部 字符 。 为 辅助 用 户 ， 标 和 俭 助 
手 为 input 元 素 额 外 添加 了 用 于 模型 验证 的 属性 ， 基 
体 将 在 第 27 章 说 明 。 








通过 在 input 元 系 上 定义 type 属 性 可 以 重 写 表 24- 
5 所 示 的 默认 映射 。 标 签 助 手 不 会 重 写 你 定义 的 
值 ， 这 人 允许 你 利用 各 种 可 用 的 input 元 系 类 型 ， 例 如 
password 或 hidden， 以 及 HTML5 中 的 新 类 型 ， 比 如 


number。 








这 种 方式 的 不 足 是 ， 必 须 在 为 给 定 的 模型 属性 
生成 input 元 际 的 所 有 视图 中 设置 type 属 性 。 如 果 需 
要 在 多 个 视图 中 敌 写 默认 了 映射 ， 可 以 为 C# 模 型 类 的 
属性 应 用 UIHint 特 性 ， 指 定 表 24-6 中 的 值 作 为 特性 
值 。 





二 


fe ZN 





如 有 果 模 型 属性 不 使 用 表 24-5 中 的 类 型 是 没有 使 
用 UIHint 特 性 进行 装饰 ， 标 签 助 手 将 设置 input 元 素 
的 type 属 性 为 text。 


4224-6 ”UIHint 特 性 值 及 其 生成 的 input 元 素 类 型 























1 url 






e 
Ur 


于 显示 DateTime 对 象 的 time 部 分 ) 
































date 《用 于 显示 DateTime 对 象 的 date 部 分 ) 


DateTime-local | datetime-local (用 于 显示 没有 提供 时 息 的 DateTime 对 象 ) 


























24.3.2 ”格式 化 数据 


当 操 作 方 法 提供 市 有 视图 模型 的 视图 时 ， 标 签 
助手 使 用 asp-for 属 性 提供 的 值 来 设置 input 元 素 的 
value 属 性 。asp-format 属 性 用 于 指定 数据 如 何 格 式 
化 。 


为 了 演示 ， 在 Home 控 制 器 中 添加 一 个 新 的 操 
作 方 法 ， 如 代码 清单 24-9 所 示 。 该 操作 方法 从 存储 
中 选取 第 一 个 City 对 象 ， 并 作为 Create 视 图 的 视图 


模型 。 


代码 清单 24-9 ”在 Controller 文 件 夹 下 的 HomeController.cs 文 件 


中 添加 操作 方法 


using Microsoft.AspNetCore.Mvc; 
using Cities.Models; 
using System.Ling; 


namespace Cities.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 
} 


public ViewResult Index() => View(repository.Ci 


ties); 


public ViewResult Edit() => View("Create", repo 
Sitory.Cities.First()); 


public ViewResult Create() => View(); 


[HttpPost ] 

[ValidateAntiForgeryToken | 

public IActionResult Create(City city) { 
repository .AddCity(city); 
return RedirectToAction("Index") ; 





如 果 运 行 应 用 程序 ， 访 问 /Home/Edit 并 检查 发 


送 给 浏览 器 的 HIML， 你 将 会 看 到 value 属 性 已 经 使 
用 视图 模型 对 象 填 充 了 ， 如 下 所 示 : 


<input class="form-control" type="number" id="Populatio 


n" 
name="Population" value="8539000" /> 





asp-format 属 性 接收 一 个 将 被 传递 给 标准 C# 字 
符 串 格式 化 系统 的 值 ， 如 代码 清单 24-10 所 示 。 


代码 清单 24-10 ”在 Views/Home 文 件 严 下 的 Create.cshtml 文 件 中 
格式 化 数据 





@model City 


@{ Layout = " Layout"; } 


<form method="post" asp-controller="Home" asp-action="C 
reate" 
asp-antiforgery="true"> 
<div class="form-group"> 
<label for="Name">Name:</label> 
<input class="form-control" asp-for="Name" /> 
</div> 
<div class="form-group"> 
<label for="Country">Country:</label> 
<input class="form-control" asp-for="Country" / 


</div> 
<div class="form-group"> 
<label for="Population">Population:</label> 
<input class="form-control" asp-for="Population 
" asp-format="{0:#, ###}" /> 
</div> 
<button type="submit" class="btn btn-primary">Add</ 
button> 


<a class="btn btn-primary" href="/Home/Index">Cance 
l</a> 


</form> 











asp-format 属 性 的 值 是 逐 字 使 用 的 ， 这 意味 着 
必须 包含 大 括号 与 “0: 引 用 ”以 及 所 需 的 格式 。 如 采 
运行 应 用 程序 并 访问 /Home/Edit， 你 将 看 到 
Population 值 被 格式 化 为 旭 下 形式 : 





<input class="form-control" type="number" id="Populatio 
n" 





name="Population" value="8,539,000" /> 


asp-format 属 性 需要 慎 用 ， 因 为 必须 确保 应 用 
程序 的 其 他 部 分 文 持 你 所 使 用 的 格式 。 在 这 种 情况 
下 ， 你 通过 格式 化 Population 的 值 引发 了 一 个 问 
题 。 标 和 俭 助 手 设 置 input 元 系 的 type 属 性 为 number， 














并 对 Population 使 用 了 表 24-5 中 的 默认 上 映射， 但 是 由 
指定 的 格式 化 串 生 成 的 value 属 性 值 包 含 非 数 字 字 
符 。 因 此 ， 章 守 number 元 素 类 型 的 浏览 句 《〈 不 是 所 
有 ， 记 住 ) 可 能 不 会 在 元 素 中 显示 任何 值 。 








你 还 必须 确保 应 用 程序 能 够 解析 你 所 使 用 的 格 
式 中 的 值 。 示 例 应 用 程序 期 望 接收 可 以 解析 为 int 
类 型 的 Population 值 ， 包 含 非 数字 字符 将 导致 验证 
错误 ， 如 第 27 章 所 述 。 








通过 模型 类 来 指定 格式 





如 果 你 总 是 希望 对 模型 属性 使 用 同样 的 格式 ， 
那么 可 以 使 用 DisplayFormat 特 性 修饰 C# 类 ， 该 特性 
定义 在 命名 空间 
System.ComponentModel.DataAnnotations 中 。 
DisplayFormat 特 性 需要 两 个 参数 来 格式 化 数据 的 
值 : DataFormatString 人 参数 指定 格式 化 串 ， 











ApplyFormatInEditMode 参 数 指定 当 值 被 编辑 时 格式 
化 也 应 被 使 用 。 代 人 码 清单 24-11 使 用 DisplayFormat 
特性 修饰 了 Population 属 性 ， 使 用 的 是 可 以 被 应 用 
程序 和 浏览 器 处 理 的 数字 格式 。 


代码 清单 24-11 ”在 Models 文 件 夹 下 的 City.cs 文 件 中 为 模型 类 
应 用 格式 化 特性 
using System.ComponentModel .DataAnnotations; 
namespace Cities.Models { 
public class City { 


public string Name { get; set; } 
public string Country { get; set; } 


[DisplayFormat(DataFormatString = "{@:F2}", App 
lyFormatInEditMode = true) ] 


public int? Population { get; set; } 


} 





属性 asp-format 优 先 于 DisplayFormat 特 性 ， 上 所 
以 需要 从 视图 中 删除 这 个 特性 ， 如 代码 清单 24-12 


所 示 。 


代码 清单 24-12 ”从 Views/Home 文 件 夹 下 的 Create.cshtml 文 件 中 
删除 格式 化 特性 


@model City 
@{ Layout = " Layout"; } 


<form method="post" asp-controller="Home" asp-action="C 
reate" 
asp-antiforgery="true"> 
<div class="form-group"> 
<label for="Name">Name:</label> 
<input class="form-control" asp-for="Name" /> 
</div> 
<div class="form-group"> 
<label for="Country">Country:</label> 


<input class="form-control" asp-for="Country" / 


</div> 
<div class="form-group"> 
<label for="Population">Population:</label> 
<input class="form-control" asp-for="Population 
" /> 
</div> 
<button type="submit" class="btn btn-primary">Add</ 
button> 
<a class="btn btn-primary" href="/Home/Index">Cance 
l</a> 
</form> 





如 果 运 行 应 用 程序 并 访问 /Home/Edit， 你 将 看 
到 Population 值 已 经 使 用 两 位 小 数 格式 化 ， 如 下 上 所 
示 : 


<input class="form-control" type="number" id="Populatio 
n" 


name="Population" value="8539000.00" /> 





24.4 ”使 用 label 元 素 


label 元 素 可 使 用 LabelTagHelper 类 进行 转换 ， 
这 个 标签 助手 使 用 视图 模型 类 来 确保 标签 的 免 输 入 
和 一 致 性 。 文 持 的 属性 只 有 asp-for， 访 属性 用 于 指 
定 label 元 素 表示 的 视图 模型 属性 。 

















Label 标 签 助 手 将 使 用 视图 模型 属性 的 名 称 
设置 for 属 性 的 值 与 label 元 素 的 内 容 。 代 人 码 清单 24- 
13 在 表单 中 为 label 元 素 应 用 了 asp-for 必 性， 它们 将 
由 标签 助手 进行 转换 。 








代码 清单 24-13 ”在 Views/Home 文 件 夹 下 的 Create.cshtml 文 件 中 
应 用 Label 标 签 助 手 


@model City 
@{ Layout = " Layout"; } 


<form method="post" asp-controller="Home" asp-action="C 
reate" 
asp-antiforgery="true" > 
<div class="form-group"> 
<label asp-for="Name"></label> 
<input class="form-control" asp-for="Name" /> 
</div> 
<div class="form-group"> 
<label asp-for="Country"></label> 


<input class="form-control" asp-for="Country" / 


</div> 
<div class="form-group"> 
<label asp-for="Population"></label> 
<input class="form-control" asp-for="Population 
" /> 
</div> 
<button type="submit" class="btn btn-primary">Add</ 
button> 
<a class="btn btn-primary" href="/Home/Index">Cance 
l</a> 
</form> 





为 label 元 素 是 空 的 ， 所 以 Label 标 签 助手 将 使 


用 模型 属性 名 称 作 为 元 系 的 内 容 并 设置 for 属 性 ， 以 
er VEDI ba a BE on SE input vo WIZ AT AN 
例 应 用 程序 ， 访 问 /Home/Create 或 /Home/Edit， 并 且 
检查 发 送 到 浏览 器 的 HTML 内 容 ， 你 将 看 到 如 下 输 
HJIR: 








<form method="post" action="/Home/Create" > 
<div class="form-group"> 
<label for="Name">Name</label> 
<input class="form-control" type="text" id="Nam 


e 
name="Name" value="London" /> 
</div> 
<div class="form-group"> 
<label for="Country">Country</label> 
<input class="form-control" type="text" id="Cou 
ntry" 


name="Country" value="UK" /> 
</div> 
<div class="form-group"> 
<label for="Population" >Population</label> 
<input class="form-control" type="number" id="P 
opulation" 
name="Population" value="8539000.00" /> 
</div> 
<button type="submit" class="btn btn-primary">Add</ 
button> 
<a class="btn btn-primary" href="/Home/Index">Cance 
l</a> 
</form> 


可 以 通过 为 模型 类 的 属性 应 用 Display 特 性 来 窗 
写作 为 label 元 系 的 内 容 ， 如 代码 清单 24-14 所 示 。 


代码 清单 24-14 在 Models 文 件 夹 下 的 City.cs 文 件 中 为 模型 属 
性 改变 说 明 信 息 
using System.ComponentModel .DataAnnotations; 
namespace Cities.Models { 
public class City { 


[Display(Name = "City")] 
public string Name { get; set; } 


public string Country { get; set; } 


[DisplayFormat(DataFormatString = "{@:F2}", App 
lyFormatInEditMode = true) ] 
public int? Population { get; set; } 


} 





SM Names w ASSURE MAE. UWR 
运行 示例 ， 访 问 /Home/Create 并 检查 发 送 给 浏览 器 
的 HTML 内 容 ， 你 将 会 看 到 label 元 素 的 内 容 已 经 改 





变 ， 如 下 所 示 : 


<div class="form-group"> 
<label for="Name">City</label> 


<input class="form-control" type="text" id="Name" n 
ame="Name" value="London" /> 
</div> 





注意 ，for 属 性 的 值 没 有 变化 ， 所 以 浏览 句 知 道 
label 元 素 已 关联 到 特定 的 input 元 素 ， 且 不 受 Display 
特性 影 啊 。 


人 


提 ”未 


可 以 通过 目 定 义 label 元 素 的 内 容 来 阻止 标签 助 
手 进行 设置 。 如 果 和 希望 label 元 素 不 只 包含 属性 的 名 
称 ， 这 将 很 有 用 ， 这 就 是 Label 标 签 助手 可 以 提供 的 





24.5 ”使 用 select 和 option 元 素 





select 和 option 元 系 为 用 户 提 供 固定 的 选择 集 
合 ， 而 不 像 mpput 元 系 那 样 文 持 所 有 可 能 的 开放 数据 
选项 。SelectTagHelper 类 负责 转换 select 元 素 ， 支 持 
的 属性 如 表 24-7 所 示 。 





4224-7 用 于 select 元 素 的 内 置 标签 助手 类 定义 的 属性 





























黄 型 


用 于 指定 select 元 素 表示 的 视图 模型 属 











属性 asp-for 用 于 设置 for 和 id 属性 以 反映 接收 的 
模型 属性 。 代 码 清单 24-15 使 用 定义 了 asp-for 属 性 的 


select 元 际 来 符 换 用 于 Country 属 性 的 input 元 素 。 


代码 清单 24-15 ”在 Views/Home 文 件 夹 下 的 Create.cshtml 文 件 中 
使 用 select 元 素 





@model City 


@{ Layout = " Layout"; } 


<form method="post" asp-controller="Home" asp-action="C 
reate" 
asp-antiforgery="true"> 
<div class="form-group"> 
<label asp-for="Name"></label> 
<input class="form-control" asp-for="Name" /> 
</div> 
<div class="form-group"> 
<label asp-for="Country"></label> 
<select class="form-control" asp-for="Country"> 
<option disabled selected value="">Select a 
Country</option> 
<option>UK</option> 
<option>USA</option> 
<option>France</option> 
<option>China</option> 
</select> 
</div> 
<div class="form-group"> 
<label asp-for="Population"></label> 
<input class="form-control" asp-for="Population 
" /> 


</div> 


<button type="submit" class="btn btn-primary">Add</ 
button> 


<a class="btn btn-primary" href="/Home/Index">Cance 
l</a> 
</form> 





这 里 手动 填充 J 了 select 元 素 的 option 元 系 ， 以 提 
供用 户 选 择 的 国家 范围 。 如 采 运 行 应 用 程序 并 访 
问 /Home/ Create, i$ A Bl] IS ZA WM has HTML 
包含 如 下 select 元 素 : 


<select class="form-control" id="Country" name="Country 
"> 

<option disabled selected value="">Select a Country 
</option> 

<option>UK</option> 

<option>USA< /option> 

<option>France</option> 

<option>China</option> 
</select> 





如 果 访 问 /Home/Edit 并 检查 发 送 到 浏览 器 的 
HTML 内 容 ， 你 将 看 到 视图 模型 属性 Country 的 值 已 
经 被 修改 为 选中 的 option 元 素 ， 如 下 所 示 : 








<select class="form-control" id="Country" name="Country 


"> 


<option disabled selected value="">Select a Country 
</option> 
<option selected="selected">UK</option> 
<option>USA</option> 
<option>France</option> 
<option>China</option> 
</select> 








ic F option7t AWE zÆ H OptionTagHelper28 
执行 的 ， 这 个 标签 助手 通过 TagHelperContext.Items 
集合 接收 来 目 SelectTagHelper 的 指令 。 如 第 23 章 所 
述 ， 标 俭 助 手 使 用 的 集合 需要 协同 工作 ， 当 创建 目 
定义 的 标签 助手 以 解决 内 置 的 限制 时 ， 可 利用 通过 
SelectTagHelper 深 加 a 到 Items 和 集合 中 的 数据 。 





24.5.1 ”使 用 数据 源 填 充 select 元 素 


显 式 定义 select 元 素 的 option 元 素 ， 对 于 选择 始 
终 具有 同样 可 能 性 的 情况 是 有 帮助 的 。 但 是 ， 妆 和 需 
要 提供 从 数据 模型 中 获取 选项 ， 或 当 需 要 在 多 个 视 
图 中 具有 相同 的 选项 集合 并 且 不 希望 手动 维护 重复 














的 内 容 时 ， 束 没有 什么 用 了 。 


24.5.2 ”从 枚 举 中 生成 option 元 系 








如 果 有 国定 的 选项 集合 呈现 给 用 户 ， 并 且 不 名 
望 在 整个 应 用 程序 的 视图 中 重复 它们 ， 那 么 可 以 使 
用 枚 举 。 在 Models 文 件 夹 中 添加 名 为 
CountryNames.cs 的 类 文件 ， 并 用 它 定 义 代码 清早 
24-16 所 示 的 枚 举 。 





代码 清单 24-16 ”Models 文 件 夹 下 的 CountryNames.cs 文 件 的 内 


IP 


AS 


namespace Cities.Models { 


public enum CountryNames { 





不 能 直接 在 asp-item 属 性 中 使 用 枚 举 ， 因 为 标 


签 助手 期 望 处 理 的 是 SelectListItem 对 象 序列 。 但 
是 ， 可 以 使 用 辅助 方法 执行 必要 的 转换 ， 如 代码 清 
单 24-17 所 示 。 


代码 清单 24-17 ”在 Views/Home 文 件 夹 下 的 Create.cshtml 文 件 中 
使 用 枚 举 生 成 option 元 素 








@model City 


@{ Layout = " Layout"; } 


<form method="post" asp-controller="Home" asp-action="C 
reate" 
asp-antiforgery="true"> 
<div class="form-group"> 
<label asp-for="Name"></label> 
<input class="form-control" asp-for="Name" /> 
</div> 
<div class="form-group"> 
<label asp-for="Country"></label> 
<select class="form-control" asp-for="Country" 
asp-items="@new SelectList(Enum.GetName 
s (typeof (CountryNames) ))"> 
<option disabled selected value= 
Country</option> 
</select> 
</div> 
<div class="form-group"> 
<label asp-for="Population"></label> 
<input class="form-control" asp-for="Population 


>Select a 


" /> 
</div> 


<button type="submit" class="btn btn-primary">Add</ 
button> 


<a class="btn btn-primary" href="/Home/Index">Cance 
l</a> 
</form> 








KEHAST, Æ optiot A Hae FET IN, 
是 为 asp-items 属 性 提供 由 枚 举 值 的 名 称 填 元 的 
SelectList 对 象 。 在 幕后 ，SelectTagHelper 关 从 
IEnumerable<SelectListItem> 生 成 option 元 素 ， 
SelectList 类 实现 了 这 个 接口 。 











如 果 运 行 应 用 程序 并 访问 /Home/Create 
或 /Home/Edit， 你 将 看 到 发 送 到 浏览 堪 的 HTML 中 
包含 与 枚 举 值 对 应 的 option 元 素 ， 如 下 所 示 : 





<select class="form-control" id="Country" name="Country 
"ys 


<option disabled selected value="">Select a Country 
</option> 

<option>UK</option> 

<option>USA< /option> 

<option>France</option> 

<option>China</option> 


</select> 


意 ， 标 签 助 手 保 留 了 占 位 en 
MR a R KERE 
不 必 在 数据 中 混合 占 位 人 符 。 








通过 模型 生成 option 元 素 





如 果 需 要 生成 option 元 素 以 反映 模型 中 的 数 
据 ， 那 么 最 简单 的 方式 是 通过 View Bag 来 提供 生成 
元 素 所 需 的 数据 ， 如 代码 清单 24-18 所 示 。 





代码 清单 24-18 在 Controllers 文 件 夹 下 的 HomeController.cs 中 
通过 View Bag 提 供 数 据 





using Microsoft.AspNetCore.Mvc; 

using Cities.Models; 

using System.Ling; 

using Microsoft.AspNetCore.Mvc.Rendering; 


namespace Cities.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 


} 
public ViewResult Index() => View(repository.Ci 
ties); 
public ViewResult Edit() { 
ViewBag.Countries = new SelectList(reposito 
ry.Cities 
-Select(c => c.Country).Distinct()); 
return View("Create", repository.Cities.Fir 
st()); 
} 
public ViewResult Create() { 
ViewBag.Countries = new SelectList(reposito 
ry.Cities 


.Select(c => c.Country).Distinct()); 
return View(); 


} 


[HttpPost] 

[ValidateAntiForgeryToken] 

public IActionResult Create(City city) { 
repository .AddCity(city); 
return RedirectToAction("Index") ; 





操作 方法 Edit 和 Create 将 ViewBag.Countries 属 性 
设置 为 使 用 存储 库 中 的 City.Country 唯 一 值 填充 的 











SelectList 对 象 。 代 人 码 清单 24-19 使 用 asp-items 属 性 告 
诉 标签 助手 为 option 元 取 从 Countries 属 性 中 获取 数 
据 。 


代码 清单 24-19 ”在 Views/Home 文 件 夹 下 的 Create.cshtml 文 件 中 
为 option 元 又 使 用 View Bag 





@model City 


@{ Layout = " Layout"; } 


<form method="post" asp-controller="Home" asp-action="C 
reate" 
asp-antiforgery="true"> 
<div class="form-group"> 
<label asp-for="Name"></label> 
<input class="form-control" asp-for="Name" /> 
</div> 
<div class="form-group"> 
<label asp-for="Country"></label> 
<select class="form-control" asp-for="Country" 
asp-items="ViewBag.Countries"> 
<option disabled selected value= 
Country</option> 
</select> 
</div> 
<div class="form-group"> 
<label asp-for="Population"></label> 
<input class="form-control" asp-for="Population 


>Select a 


" /> 


</div> 
<button type="submit" class="btn btn-primary">Add</ 
button> 


<a class="btn btn-primary" href="/Home/Index">Cance 
l</a> 
</form> 





如 果 运 行 应 用 程序 并 访问 /Home/Create 
或 /Home/Edit， 你 将 看 到 生成 的 option 元 素 ， 如 下 所 
不 : 
<select class="form-control" id="Country" name="Country 
"> 


<option disabled selected value="">Select a Country 
</option> 


<option selected>UK</option> 

<option>USA< /option> 

<option>France</option> 
</select> 





2. 使 用 上 自 定 义 的 标签 助手 从 模型 生成 option 元 素 


通过 View Bag 为 option 元 素 传 递 数 据 的 问题 在 
于 ， 必 须 在 每 个 演 染 视图 的 操作 方法 中 留意 为 标签 
助手 生成 数据 ， 这 将 导致 代码 的 重复 。 你 可 以 在 代 








人 码 清单 24-18 中 获取 一 些 感觉 ， 这 使 得 测试 和 维护 
控制 鼎 变 得 更 加 困难 。 





更 好 的 方式 是 创建 日 定义 的 标签 助手 来 文 持 内 
置 的 SelectTagHelper 类 。 在 Infrastructure/TagHelper 
文件 夹 中 创建 名 为 SelectOptionTagHelper.cs 的 类 文 
件 ， 定 义 代码 清单 24-20 所 示 的 类 。 


代码 清单 24-20 ”Infrastructure/TagHelper 文 件 夹 下 的 
SelectOptionTagHelper.cs 文 件 的 内 容 





using System; 

using System.Ling; 

using System.Reflection; 

using System. Threading. Tasks; 

using Cities.Models; 

using Microsoft.AspNetCore.Mvc.ViewFeatures; 
using Microsoft.AspNetCore. Razor. TagHelpers; 


namespace Cities.Infrastructure.TagHelpers { 


[HtmlTargetElement("select", Attributes = "model-fo 


r")] 
public class SelectOptionTagHelper : TagHelper { 
private IRepository repository; 


public SelectOptionTagHelper(IRepository repo) 


repository = repo; 


} 


public ModelExpression ModelFor { get; set; } 


public override async Task ProcessAsync(TagHelp 
erContext context, 
TagHelperOutput output) { 


output.Content.AppendHtml ( 
(await output.GetChildContentAsync(fals 
e)).GetContent()); 


string selected = ModelFor.Model as string; 


PropertyInfo property = typeof(City) 
.GetTypeInfo() .GetDeclaredProperty (Mode 
1For.Name) ; 
foreach (string country in repository.Citie 
S 
.Select(c => property.GetValue(c)). 
Distinct()) { 
if (selected != null && selected.Equals 
(country, 
StringComparison.OrdinalIgnoreC 
ase)) { 
output.Content 
.AppendHtm1($"<option selected> 
{country}</option>"); 
} else { 
output.Content.AppendHtm1($"<option 
>{country}</option>") ; 
} 
} 


output.Attributes.SetAttribute("Name", Mode 


lFor .Name); 
output.Attributes.SetAttribute("Id", ModelF 
or.Name) ; 


} 


} 
} 





该 标签 助手 通过 model-for 属 E ile 
执行 操作 ， 并 使 用 依赖 注入 接收 可 以 不 依赖 演 染 
图 的 来 自控 制 器 的 用 于 访问 模型 数据 cae 
象 。 访 标签 助手 定义 了 异步 的 ProcessAsync 方 法 ， 
从 而 简化 了 Aube 保留 select 元 又 中 任何 现 有 内 容 的 
过 程 ， 这 是 通过 GetChildContentAsync 方 法 实现 
的 。 








SelectTagHelper 指 示 应 通过 Items 集 合 中 的 选 
(使 用 目 己 的 类 型 为 键 〉 选择 option 元 素 的 -i 
该 标 位 助手 获取 已 选中 选项 的 列表 ， 并 与 LINQ 奏 
询 结 果 结 合 使 用 ， 以 便 为 存储 库 中 的 每 个 唯一 值 生 
成 option 元 素 。 人 代码 清单 24-21 更 新 了 Select 元素， 以 
便 asp-items 属 性 被 model-for 属 性 蔡 换 ， 还 添加 了 








@addTagHelper 表 达 式 ， 从 而 仅 为 Create 视 图 局 用 目 
定义 的 标签 助手 。 





代码 清单 24-21 在 Views/Home 文 件 夹 下 的 Create.cshtml 文 件 中 
启用 目 定 义 的 标签 助手 





@model City 


@addTagHelper Cities.Infrastructure.TagHelpers.SelectOp 
tionTagHelper, Cities 


@{ Layout = " Layout"; } 


<form method="post" asp-controller="Home" asp-action="C 
reate" 
asp-antiforgery="true"> 
<div class="form-group"> 
<label asp-for="Name"></label> 
<input class="form-control" asp-for="Name" /> 
</div> 
<div class="form-group"> 
<label asp-for="Country"></label> 
<select class="form-control" model-for="Country 


> 
<option disabled selected value="">Select a 
Country</option> 
</select> 
</div> 


<div class="form-group"> 
<label asp-for="Population"></label> 
<input class="form-control" asp-for="Population 


" /> 


</div> 
<button type="submit" class="btn btn-primary">Add</ 
button> 


<a class="btn btn-primary" href="/Home/Index">Cance 
l</a> 
</form> 





新 的 标签 助手 会 生成 同样 的 内 容 ， 但 是 不 需要 
内 置 标签 助手 要 求 的 View Bag 数 据 。 这 种 方式 让 操 
作 方 法 可 以 专注 于 它们 的 特定 任务 ， 并 保持 应 用 程 
序 的 整体 外 观 。 








24.6 ”使 用 textarea 元 素 


textarea 元 系 用 于 从 用 户 获 取 更 多 的 文本 ， 通 第 
用 于 非 结构 化 数据 ， 比 如 注释 或 观测 结果 。 
TextAreaTagHelper 负 贡 转 换 textarea 元 素 ， 并 文 持 单 
个 属性 asp-for， 该 属性 用 于 指定 textarea 元 素 表示 的 
视图 模型 属性 。 








TextAreaTagHelper 类 相对 人 简单， 为 asp-for 属 性 





提供 的 值 用 于 为 textarea 元 素 设 置 d 和 name 属 性 。 为 
了 演示 这 个 标签 助手 ， 为 City 模 型 类 添加 了 一 个 新 
的 属性 ， 如 代码 清单 24-22 所 示 。 


代码 清单 24-22 ”在 Models 文 件 夹 下 的 City.cs 文 件 中 添加 属性 


using System.ComponentModel.DataAnnotations; 
namespace Cities.Models { 
public class City { 


[Display(Name = "City")] 
public string Name { get; set; } 


public string Country { get; set; } 


[DisplayFormat(DataFormatString = "{0:F2}", App 
lyFormatInEditMode = true) ] 
public int? Population { get; set; } 


public string Notes { get; set; } 





代码 清单 24-23 在 Create.cshtml 视 图 文件 中 添加 
了 一 个 textarea 元 素 ， 并 使 用 asp-for 属 性 关联 这 个 元 


素 到 City 类 的 Notes 属 性 


代码 清单 24-23 ”在 Views/Home 文 件 夹 下 的 Create.cshtml 文 件 中 
添加 文本 区 域 








@model City 
@addTagHelper Cities.Infrastructure.TagHelpers.SelectOp 
tionTagHelper, Cities 


@{ Layout = " Layout"; } 


<form method="post" asp-controller="Home" asp-action="C 
reate" 
asp-antiforgery="true"> 
<div class="form-group"> 
<label asp-for="Name"></label> 
<input class="form-control" asp-for="Name" /> 
</div> 
<div class="form-group"> 
<label asp-for="Country"></label> 
<select class="form-control" asp-for="Country" 
asp-items="ViewBag.Countries"> 
<option disabled selected value="">Select a 
Country</option> 
</select> 
</div> 
<div class="form-group"> 
<label asp-for="Population"></label> 
<input class="form-control" asp-for="Population 
" /> 
</div> 
<div class="form-group"> 


<label asp-for="Notes"></label> 


<textarea class="form-control" asp-for="Notes"> 
</textarea> 


</div> 


<button type="submit" class="btn btn-primary">Add</ 
button> 


<a class="btn btn-primary" href="/Home/Index">Cance 
l</a> 


</form> 








如 果 运 行 应 用 程序 并 访问 /Home/Create 
或 /Home/Edit。 你 将 看 到 发 送 给 浏览 器 的 HTML 包 
含 如 下 所 示 的 textarea 元 素 : 


<div class="form-group"> 
<label for="Notes">Notes</label> 


<textarea id="Notes" name="Notes"></textarea> 
</div> 





TextAreaTagHelper 类 相对 简单 ， 但 它 提 供 了 本 
草 介 绍 的 其 他 表单 标 位 助手 的 一 致 性 





24.7 ”验证 表单 标签 助手 





与 HIML 表 单 相关 的 其 他 标签 助手 有 两 个 〈 见 


表 24-8) ， 将 在 第 27 章 详 加 说 明 。 这 两 个 标签 助手 
用 于 在 用 户 提 供 的 数据 不 满足 应 用 程序 的 期 望 时 间 
用 户 提 供 反 人 馈 。 














表 24-8 ”验证 表单 标签 助手 




















ValidationMessage 有 于 提供 单个 表单 元 素 的 验证 反馈 











ValidationSummary 由 于 提供 关于 表单 所 有 元 素 的 验证 反馈 











24.8 ”小 结 





本 章 介 绍 了 用 于 转换 HTML 表 单元 素 的 内 置 标 
签 助 手 。 这 些 标签 助手 确保 表单 直接 从 模型 类 和 
成 ， 这 减少 了 潜在 的 错误 并 提供 一 致 的 方式 来 编写 
Razor 视 图 。 下 一 章 将 介绍 其 他 内 置 标签 助手 ， 它 
们 用 于 对 一 系列 各 不 相同 的 HTML 元 素 进 行 操作 。 

















第 25 草 ”使 用 其 他 内 置 标签 助手 


第 24 章 介绍 的 标签 助手 专注 于 生成 HTML 表 
单 ， 但 这 不 是 仅 有 的 ASP.NET Core MVC 内 置 标签 
助手 。 本 和 章 将 介绍 用 于 管理 JavaScript 脚 本 与 CSS 样 
式 表 ， 为 超 链接 元 素 创 建 URL， 为 图 片 元 素 提 供 绥 
存 清除 ， 以 及 文 持 数据 绥 存 的 标签 助手 。 本 章 还 会 
介绍 提供 应 用 程序 相关 的 URL 支 持 的 标签 助手 ， 以 
确保 在 应 用 程序 被 发 布 到 与 其 他 应 用 程序 共享 的 环 
境 中 时 ， 浏 览 器 可 以 访问 静态 内 容 。 表 25-1 列 出 了 


本 章 要 介绍 的 操作 。 











表 25-1 本 章 要 介绍 的 操作 
































单 25-2 和 代码 清 自 










































































为 Script 元素 应 用 asp-src-include 与 asp-src- | 代码 清单 25-3 一 代码 清单 


; VA AH: 
选择 JavaScript 文 人 exclude 属 性 25-7 





































































































为 JavaScript 使 4 FU : à 25-9 和 代码 清 ` 
为 script 元 素 应 用 asp-fallback 属 性 
CDN 























元 素 应 用 asp-href-include 与 asp-href- 


mR LE 




















选择 CSS 文 件 






























































为 link 元 素 应 用 asp-fallback 属 忻 

















为 anchor 元 素 生成 
URL 
































H AnchorTagHelper 








确保 图 像 的 修改 被 
检测 
































为 img 元 素 应 用 asp-append-version 属 性 



































单 25-15 一 代码 清 























月 cache 元 素 























创建 应 用 程序 相关 要 码 清单 25-24 一 代码 清 
~ 字符 添加 UREL 前 绥 
的 URL 



































25.1 准备 示例 项 目 


本 章 继 续 使 用 第 24 章 的 Cities 项 目 ， 创 建 


wwwrootUimages 文 件 严 ， 并 在 其 中 添加 名 为 city.png 
的 图 片 文件 。 这 是 一 张 纽 约 天 际 线 的 公用 全 景 照 
片 ， 如 图 25-1 所 示 。 





图 25-1 ”添加 图 片 到 项 目 中 


这 幅 图 片 包 含 在 本 章 有 的 源 代码 中 。 如 果 需 要 下 
RAN BID, Ea eA CNA 





本 章 要 做 的 其 他 调整 是 使 用 Bower 将 jQuery 加 
入 项 目 中 ， 如 代码 清单 25-1 所 示 。 


代码 清单 25-1 在 Cities 文 件 夹 下 的 bower.json 文 件 中 添加 
jQeury 





"name": "asp.net", 
"private": true, 
"dependencies": { 
"bootstrap": "4.0.@-alpha.6", 
"jquery": "3.2.1" 


} 
如 果 运 行 应 用 程序 ， 你 将 能 够 列 出 存储 库 中 的 
对 象 ， 并 创建 新 的 对 象 ， 如 图 25-2 所 示 。 





Paris 


Population 





Notes 


图 25-2 ”运行 示例 应 用 
25.2 ”使 用 和 宿主 环境 标签 助手 


通过 将 EnvironmentTagHelper 类 应 用 于 目 定 义 
的 environment 元 和 素 ， Raped EM BER EE OR 
RA A AIFS as, BIENE ANTAN. F 
始 时 这 可 能 看 起 来 不 太 油 动人 心 ， 但 是 随后 需要 借 


助 这 个 标签 助手 以 元 分 利用 一 些 相关 的 功能 。 
environment 元 素 依 赖 于 names 属 性 ， 该 属性 用 于 指 
定 一 个 以 逗号 分 隅 的 答 主 环境 名 称 列表 ， 包 含 在 
environment R H HI A RRES ERIE FI) A Hi 
的 HTML 中 。 














代码 清单 25-2 在 共享 的 布局 文件 中 添加 了 
environment 元 素 ， 对 于 开发 和 生产 环境 ， 分 别 在 视 
图 中 包含 不 同 的 内 容 。 


代码 清单 25-2 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 中 使 


用 environment 元 素 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 

<title>Cities</title> 

<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 

<environment names="development"> 

<div class="m-1 p-1 bg-info"><h2>This is Develo 


pment</h2></div> 

</environment> 

<environment names="production"> 

<div class="m-1 p-1 bg-danger"><h2>This is Prod 

uction</h2></div> 

</environment> 

<div>@RenderBody()</div> 
</body> 
</html> 





图 25-3 展 示 了 在 开发 和 生产 宿主 环境 下 运行 应 
用 程序 的 效果 。 naa 检查 当前 的 宿主 环 
境 名 称 ， 以 及 是 否 包 含 或 忽略 内 容 (environment 元 
pe a 岩 的 HTML 中 ) 。 





图 25-3 ”使 用 宿主 环境 管理 内 容 


25.3 ”使 用 JavaScript 和 CSS 标 俭 助 手 


另 一 类 内 置 的 标签 助手 用 来 通过 script 和 1link 元 





际 管 理 JavaScript 和 CSS 样 式 表 。 通 音 它 们 包含 于 共 
享 布局 中 。 这 些 标签 助手 强大 而 灵活 ， 但 是 需要 密 
切 注意 以 避免 产生 意外 的 结果 。 





25.3.1 $ JavaScript k 4# 


内 置 的 ScriptTagHelper 类 是 用 于 script 元 素 并 在 
视图 中 管理 JavaScript 文 件 的 标签 助手 ， 可 使 用 表 
25-2 所 示 的 属性 包含 JavaScript 文 件 ， 随 后 将 进行 说 
HH 





4225-2 用 于 script 元 素 的 内 置 标签 助 手 类 定义 的 属性 



































asp-src-include 
asp-src-exclude 



































asp-append-version 有 于 缓存 清除 
asp-fallback-src 日 于 指定 在 使 用 CDN 有 问题 时 ， 需 要 使 用 的 回 退 JavaScript 文 件 

















asp-fallback-src- 











月 于 指定 在 使 用 CDN 有 问题 时 ， 将 被 使 用 的 JavaScript 文 件 





include j 


asp-fallback-src- 





有 于 指定 当 CDN 有 问题 时 ， 将 被 排除 的 JavaScript 文 件 





exclude 








日 于 指定 一 段 JavaScript， 从 而 判断 JavaScript 代 人 码 是 否 已 从 CDN 正 确 
下 载 





asp-fallback-test 





1. 选择 JavaScript 文 件 


属性 asp-src-include 使 用 通配符 在 视图 中 包 
JavaScript 文 件 。 如 第 7 章 所 述 ， pp 
系列 通配符 用 于 匹配 文件 。 表 25-3 摘 述 了 种 用 的 通 
配 符 。 


表 25-3 FW A PF 












































匹配 除 / 之 外 的 任意 单个 字符 。 示 例 匹 配 包 含 于 js 文件 夹 中 ， 能 匹配 名 称 为 src 
? |js/src?.js | 后 跟 任意 一 个 字符 且 以 .js 结尾 的 任何 文件 ， 例 如 js/src1.js 和 js/srcX.js， 但 是 不 
匹配 js/src123.js 或 js/mydirsrc1.js 











































































































ae 匹配 除 /之 外 任意 数量 的 任意 字符 。 示 例 匹 配 包含 于 js 文件 夹 中 ， 能 匹配 以 .js 
* | js/*.js 
ie 为 扩展 名 的 任意 文件 ， 例 如 js/src1.js 和 js/src123.js， 但 是 不 包括 js/mydir/src1.js 
























































jg/**/* j 匹配 包含 /的 任意 数量 的 任意 字符 。 示 例 匹 配 包括 js 目录 及 其 录 中 以 .js 为 
k S xk K S 
| i 扩展 名 的 任何 文件 ， 例 如 /js/src1.js 和 /js/mydir/src1.js 


通过 asp-src-include 属 性 使 用 通配符 模式 ， 意 味 





看 应 用 程序 中 的 视图 将 总 是 包含 这 些 JavaScript 文 
件 ， 即 使 文件 的 名 称 或 路 径 发 生变 化 ， 以 及 文件 被 
添加 或 被 删除 。 代 码 清单 25-3 选 择 了 jQuery 包 中 的 
文件 ， 可 使 用 Bower 将 jQuery 安装 到 

wwwrootUlib/jquery/dist 文 件 夹 中 。 


代码 清单 25-3 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 件 
中 选择 JavaScript 文 件 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 

<title>Cities</title> 

<script asp-src-include="/1lib/jquery/dist/**/*.js"> 
</script> 


<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
<div>@RenderBody()</div> 
</body> 
</html> 








以 上 示例 中 使 用 的 通配符 很 常用 。 通 配 符 在 
wwwroot 文 件 夹 中 被 计算 ， 其 中 jQuery 库 可 作为 单 
个 名 为 jquery.js 的 文件 发 布 。 


以 上 通配符 试图 选择 文件 ， 以 适应 jQuery 在 未 
来 发 布 中 的 变化 ， 例 如 改变 JavaScript 文 件 名 称 。 如 
果 运 行 示 例 应 用 程序 并 检查 友 送 到 浏览 器 的 HTML 
内 容 ， 你 将 会 发 现 里 面包 含 错误 ， 如 下 所 示 : 








<head> 
<meta name="viewport" content="width=device-width" 


<title>Cities</title> 

<script src="/1ib/jquery/dist/core.js"></script> 
<script src="/1ib/jquery/dist/jquery.js"></script> 
<script src="/1ib/jquery/dist/jquery.min.js"></scri 


<script src="/1ib/jquery/dist/jquery.slim.js"></scr 


<script src="/1ib/jquery/dist/jquery.slim.min.js">< 
/script> 

<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 
</head> 





ScriptTagHelper 类 为 由 配 通 过 asp-src-include 属 
性 传递 的 通配符 的 每 个 文件 生成 一 个 script 元 素 ， 而 
不 只 是 选择 jquery.js 文 件 ，jquery.min.js 是 紧 织 版 本 
的 jquery.js 交 件 ， 此 处 还 有 正常 和 紧缩 版 本 的 jQuery 
库 core 和 slim。 





由 于 Visual Studio 默 认 隐 藏 了 ， 因 此 你 可 能 没 
章 识 到 jQuery 发 行 版 包含 紧缩 文件 。 为 了 展现 
wwwroot/ lib/jquery/dist 文 件 夹 中 的 全 部 内 容 ， 必 须 
在 Solution Explorer 窗 格 中 展开 jquery.js， 然 后 同样 
展开 jquery.min.js， 如 图 25-4 所 示 。 


px 


rer 
z > 
> © 5 -| T- S & DI sotttion plorer OMS -|o-s##B|s—= 
Search Solution Explorer (Ctrl+: DAS- S Solution Explorer (Ctrl+:) 
h Solution Explorer (Ctri+;) 


Pp- 














图 25-4 Solution Explorer 窗 格 中 展现 目录 的 填充 内 容 


代码 清单 25-3 中 使 用 的 通配符 会 将 jQuery 代码 
加 入 浏览 占 多 次 ， 这 不 仅 浪 费 囊 冤 而 且 拖 慢 了 应 用 
程序 的 下 载 速度 。 对 于 茶 些 库 ， 可 能 导致 错误 或 未 
预期 的 行为 。 解 决 这 个 问题 有 3 种 方式 ， 这 些 方式 
随后 进行 说 明 。 


使 用 源码 映射 


JavaScript 文 件 通 过 紧缩 来 减少 尺寸 ， 这 意味 着 





AY LA SE RHE AIA BI Fe Phin, SEA BED Nir tit. RAR 
过 程 会 从 源 文 件 中 删除 所 有 的 空白 ， 重 命名 函数 和 
变量 ， 比 如 myHelpfullyNamedFunction 可 使 用 更 少 
数量 的 字符 来 表示 ， 例 如 xl1。 当 在 紧缩 代码 中 使 用 
浏览 器 的 调试 器 来 追踪 错误 时 ，x1 这 样 的 名 字 使 得 
几乎 不 可 能 进行 代码 跟 踩 。 








jquery.min.map 文件 是 源码 映射 文件 ， 有 些 浏 
览 器 可 以 用 它 提 供 紧 缩 代 但 与 开发 者 可 读 的 未 紧缩 
源码 间 的 映射 。 





在 写作 本 书 时 ， 源 码 映 射 还 不 是 通用 的 文 持 特 
性 ， 但 可 以 在 最 新 版 本 的 Chrome 和 Edge 浏 览 右 中 使 
用 。 例 如 ， 在 Chrome 浏 览 器 中 ， oA cae 
上 共 窗 口 ， 浏 览 器 将 上 自动 请 求 源 但 映射 文件 ， 这 意味 
着 在 发 送 紧 缩 版 本 的 JavaScript 文 件 时 ， 仍 然 可 以 轻 
松 局 用 调试 。 


2. 限制 通配符 


许多 库 同 时 提供 正 疝 和 运 缩 版 本 的 JavaScript 文 
件 ， 如 果 仅 仅 和 希望 使 用 紧缩 版 本 ， 那 么 可 以 限制 通 
配 符 匹配 的 文件 ， 如 代码 清单 25-4 所 示 。 如 果 并 不 
期 望 使 用 调试 版 本 的 jQuery 库 ， 因 为 它们 编写 恨 
好 ， 问 题 很 少 ， 或 者 知道 浏览 器 支持 源码 映射 ， 那 
么 这 是 一 种 不 错 的 方式 。 








代码 清单 25-4 在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 件 
中 仅仅 使 用 紧缩 版 本 的 JavaScript 文 件 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 

<title>Cities</title> 

<script asp-src-include="/1lib/jquery/dist/**/*.min. 
js"></script> 

<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 


</head> 

<body class="m-1 p-1"> 
<div>@RenderBody()</div> 

</body> 

</html> 





URT A Ee PR AIK BD A) 
HTML, (RSPAS AGA jQuery X 
件 。 


<head> 
<meta name="viewport" content="width=device-width" 


/> 
<title>Cities</title> 
<script src="/1ib/jquery/dist/jquery.min.js"> 


</script><script src="/1lib/jquery/dist/jquery.slim. 
min.js"></script> 

<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 
</head> 





FER BRS iil] HAC FF 2 ES BI EF, (ELE as IA 
最 终 发 送 了 正常 和 轻 量 版 本 的 jQuery 库 〈 轻 量 版 本 
忽略 了 一 些 不 第 用 的 功能 ， 详 见 jQuery 网 站 ) 。 为 


了 进一步 限制 ， 可 以 在 统 配 模板 中 只 包含 轻 量 版 





本 ， 如 代码 清单 25-5 所 示 。 


代码 清单 25-5 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 件 
中 做 进一步 限制 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Cities</title> 
<script asp-src-include="/1lib/jquery/dist/**/*.slim 


-min.js"></script> 
<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
<div>@RenderBody()</div> 
</body> 
</html> 








结 朱 是 只 有 一 个 版 本 的 jQuery 文件 和 被 及 送 到 浏 
响 硕 中 ， 但 仍然 你 持 了 文件 位 置 的 灵活 性 。 








<head> 

<meta name="viewport" content="width=device-width" 
/> 

<title>Cities</title> 

<script src="/1ib/jquery/dist/jquery.slim.min.js">< 


/script> 

<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 
</head> 





1) 排除 文件 


当 和 希望 选择 的 文件 名 中 包含 特定 术语 时 ， 限 制 
通配符 是 有 帮助 的 ， 但 是 在 没有 特定 术语 的 时 候 ， 
就 没有 什么 用 了 。 比 如 ， 当 希望 包含 完全 版 本 的 紧 
缩 文件 时 。 笠 运 的 是 ， 可 以 使 用 asp-src-exclude 属 
性 ， 从 asp-src-include 属 性 匹配 的 文件 中 移 除 文件 ， 
如 代码 清单 25-6 所 示 。 








代码 清单 25-6 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 件 
中 排除 文件 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 

<title>Cities</title> 

<script asp-src-include="/1lib/jquery/dist/**/*.min. 
js" 


asp-src-exclude="**.slim. **"> 

</script> 

<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 

<div>@RenderBody()</div> 
</body> 
</html> 





运行 示例 应 用 程序 并 检查 发 送 到 浏览 器 的 
HTML， 你 将 会 看 到 只 包含 完全 紧缩 版 本 的 
JavaScript 文 件 。 


<head> 

<meta name="viewport" content="width=device-width" 
/> 

<title>Cities</title> 


<script src="/1ib/jquery/dist/jquery.min.js"></scri 
pt> 

<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 
</head> 





PPE BAN BY BA 2 SE AB ASH SC 
件 ， 在 开 及 时 这 很 有 用 ， 如 代码 清单 25-7 所 示 。 


代码 清单 25-7 在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 件 


中 选取 非 紧 缩 文 件 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 
<title>Cities</title> 
<script asp-src-include="/lib/jquery/dist/**/j*.js" 
asp-src-exclude="**.slim.**, ** min.**"> 
</script> 
<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
<div>@RenderBody()</div> 
</body> 
</html> 








ER, PY DE Ss or MORE BS PATE oO 
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HTML, 你 将 会 看 到 只 有 非 紧 缩 版 本 的 JavaScript 文 
FROS : 





<head> 
<meta name="viewport" content="width=device-width" 


/> 
<title>Cities</title> 
<script src="/1ib/jquery/dist/jquery.js"></script> 


<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 
</head> 





2) 使 用 宿主 环境 来 选择 文件 


常见 的 工作 方式 是 在 开发 过 程 中 使 用 常规 版 本 
的 JavaScript 文 件 ， 这 使 调试 变 得 简单 ， 然 后 在 生产 
环境 中 使 用 紧缩 版 本 的 JavaScript 文 件 ， 从 而 节省 了 
市 宽 。 这 可 以 通过 使 用 environment 元 素 ， 基 于 牡 主 
环境 选择 包含 的 Script 元 系 来 实现 ， 如 代码 清单 25-8 
所 示 。 





代码 清单 25-8 在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 中 使 
用 宿主 环境 来 选择 文件 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 
<title>Cities</title> 
<environment names="development"> 
<script asp-src-include="/1lib/jquery/dist/**/j* 
js" 


asp-src-exclude="**.slim. **, **.min.**"> 
</script> 
</environment> 
<environment names="staging, production"> 
<script asp-src-include="/lib/jquery/dist/**/*. 
min.js" 
asp-src-exclude="**.slim, **"> 
</script> 
</environment> 
<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
<div>@RenderBody()</div> 
</body> 
</html> 











这 种 方式 的 优势 在 于 可 基于 牡 主 环境 适 配 应 
用 ， 但 也 意味 着 不 得 不 编写 和 维护 多 个 script 元 素 。 


BAF ER 


可 经 常 缓存 静态 内 容 〈 如 图 片 、CSS 样 式 表 以 
及 JavaScript 文 件 ) 以 停止 从 应 用 服务 喜 请 求 很 少 弯 
化 的 内 容 。 绥 存 可 以 通过 多 种 途径 完成 : 浏览 右 可 


以 被 告知 缓存 来 目 服务 器 的 内 容 ， 应 用 程序 可 以 使 
用 缓存 服务 絮 来 文 持 应 用 服务 占 ， 或 者 通过 内 容 分 
发 网 络 来 分 及 内 容 。 不 是 所 有 的 缓存 部 在 你 的 控制 
Z Po øu, KØER ARRITI T w» 
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缓存 的 问题 是 ， 客 户 端 在 部 署 时 不 会 立即 收 到 
新 版 本 的 静态 文件 ， 因 为 它们 的 请 求 仍 由 以 前 缓存 
的 内 容 处 理 。 最 终 ， 缓 存 的 内 容 将 过 期 ， 并 且 将 使 
用 新 内 容 ， 但 这 会 留 下 一 段 时 间 ， 在 这 段 时 间 ， 应 
用 程序 控制 器 生成 的 动态 内 容 与 缓存 交付 的 静态 内 
容 不 同步 。 根 据 更 新 的 内 容 ， 这 可 能 导致 布局 问题 
或 应 用 程序 异常 。 


解决 这 个 问题 的 方法 称 为 缓存 清除 。 思 路 是 允 
许 缓存 处 理 静态 内 容 ， 但 是 当 内 容 在 服务 器 上 被 修 
改 之 后 立即 做 出 反应 。 标 签 助 手 通 过 在 用 于 静态 内 
容 的 URL 碍 询 串 后 包含 校 验 和 作为 版 本 来 文 持 。 例 


如 ，ScriptTagHelper 关 通过 asp-append-version 属 性 
来 文 持 绥 存 清除 。 





<script asp-src-include="/lib/jquery/dist/**/j*.js" 
asp-src-exclude="**.slim.**, ** min. **" 


asp-append-version="true"> 
</script> 





启用 缓存 清除 导致 生成 的 发 送 到 浏览 器 的 
HTML 元 素 如 下 所 示 : 


<script src="/lib/jquery/dist/jquery.min. js?v=3ZRSQ1HF - 
ocUiVcdv9yKTXqM" > 


</script> 





同样 的 版 本 号 也 可 以 用 于 标签 助手 ， 和 直至 改变 
文件 的 内 容 ， 比 如 更 新 JavaScript 库 ， 此 刻 另 一 个 不 
同 的 校 验 和 将 被 计算 出 来 。 附 加 版 本 号 意味 着 每 次 
修改 文件 时 ， 客 忆 端 将 请 求 不 同 的 URL， 此 前 缓存 
的 内 容 无 法 达成 ， 绥 存 视 为 对 新 内 容 的 请 求 并 友 送 


到 应 用 服务 左 。 内 容 将 正 向 缓存 直到 下 一 次 更 新 ， 
这 将 生成 力 一 个 具有 不 同 版 本 的 URL。 


3. 使 用 CDN 


内 容 分 发 网 络 (Content Delivery Network,， 
CDN) 用 于 将 用 户 请 求 分 流 到 离 用 户 更 近 的 服务 
器 。 浏 览 右 不 是 从 应 用 服务 器 请 求 JavaScript 文 件 ， 
而 是 从 解析 为 本 地 服务 器 的 主机 来 请 求 ， 这 减少 了 
加 载 文 件 所 需 的 时 间 ， 降 低 了 为 应 用 程序 提供 的 市 
宽 。 如 采 拥 有 庞大 的 、 广 域 分 布 的 用 户 群 ， 那 么 可 
以 使 用 商业 注册 的 CDN， 但 是 即使 对 于 最 小 和 最 们 
单 的 应 用 程序 ， 也 可 以 通过 受益 于 由 主流 技术 公司 
党 理 的 免费 CDN 来 分 发 通用 的 JavaScript 包 ， 例 如 
jQuery. 

















本 章 将 使 用 微软 提供 的 CDN， 它 们 对 流行 的 包 
提供 免费 访问 ， 可 以 在 ASP.NET 网 站 上 找到 微软 提 
供 的 CDN 清 单 。 对 于 jQuery 3.2.1， 有 6 个 包 : 


e jquery-3.2.1.js; 

e jquery-3.2.1.min.js; 

e jquery-3.2.1.min.map; 

e jquery-3.2.1.slim.js; 

e jquery-3.2.1.slim.min.js; 


e jquery-3.2.1.slim.min.map -o 








这 些 包 可 以 为 完全 版 本 和 轻 量 版 本 提供 常规 的 
JavaScript 文 件 、 紧 缩 的 JavaScript 文 件 以 及 紧缩 文 
件 的 源码 映射 文件 。 代 码 清单 25-9 通 过 修改 示例 应 
用 中 的 布局 文件 来 使 用 CDN 获 取 的 紧缩 文件 蔡 换 本 
地 文件 。 








代码 清单 25-9 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 中 使 
用 CDN 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Cities</title> 
<script src="****; //ajax.aspnetcdn. ***/ajax/jQuery/ 
jquery-3.2.1.min.js"></script> 
<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
<div>@RenderBody()</div> 
</body> 
</html> 





指定 CDN 意 味 着 对 于 jQuery 文件 没有 请 求 到 达 
应 用 服务 器 。 使 用 CDN 的 问题 是 CDN 不 在 你 的 控制 
之 下 ， 这 意味 着 CDN 可 能 失效 ， 只 剩 下 应 用 程序 在 
运行 ， 但 是 不 能 如 预期 那样 工作 ， 因 为 CDN 内 容 不 
可 用 。 为 了 帮助 解决 这 一 问题 ，ScriptTagHelper 类 
提供 了 在 CDN 内 容 不 能 加 载 到 客户 端 时 回 退 到 本 地 
文件 的 能 力 ， 如 代码 清单 25-10 所 示 。 











代码 清单 25-10 ”在 Views/Shared 文 件 夹 下 的 Layout.cshtml 中 使 
用 CDN 回 退 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 


<title>Cities</title> 
<script src="****; //ajax.aspnetcdn. ***/ajax/jQuery/ 
jquery-3.2.1.min.js" 
asp-fallback-src-include="/1ib/jquery/dist/ 
**/* min.js" 


asp-fallback-src-exclude="**.slim, **" 
asp-fallback-test="window. jQuery" > 
</script> 
<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
<div>@RenderBody()</div> 
</body> 
</html> 





属性 asp-fallback-src-include 与 asp-fallback-src- 
exclude 用 于 在 CDN 不 能 通过 第 规 的 src 属 性 分 发 内 
容 时 选择 和 排除 本 地 文件 。 为 了 判断 CDN 是 人 否 正 第 
工作 ，asp-fallback-test 属 性 用 于 定义 在 浏览 句 端 执 
行 的 JavaScript 片 段 ， 如 果 执 行 结果 为 false， 那 么 回 
退 文件 将 被 请 求 。 


运行 应 用 程序 并 检查 发 送 到 客户 端的 HIML， 
你 将 看 到 ScriptTagHelper 类 从 asp-fallback-test 属 性 取 
出 JavaScript 片 段 并 用 它 生 成 另 一 个 script 元 素 ， 如 
下 所 示 : 


<head> 

<meta name="viewport" content="width=device-width" 
/> 

<title>Cities</title> 

<script src="****:;//ajax.aspnetcdn. ***/ajax/jQuery/ 
jquery-3.2.1.min.js"> 

</script> 

<script> 


(window. jQuery | |document .write("\u@@3Cscript 
src=\u0@22\/1lib\/jquery\/dist\/jquery.min.js 
\uU@022\UG83E\Uee3C\/script\UuUGe3E")); 

</script> 

<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 
</head> 





如 果 文 件 从 CDN 加 载 ， 那 么 你 在 asp-fallback- 
test 属 性 中 指定 的 JavaScript 厂 段 必 须 返 回 true; 7 
则 ， 返 回 false。 最 简单 的 方式 通常 是 检查 JavaScript 
代码 提供 的 功能 入 口 点 。jQuery 库 在 公共 的 window 


对 象 上 创建 了 名 为 jQuery 的 函数 ， 这 也 是 代码 清单 
25-10 要 测试 的 内 容 。 你 需要 为 从 CDN 加 载 的 每 个 
文件 找到 等 价 的 测试 。 


测试 回 退 设置 也 很 重要 ， 因 为 在 CDN 停 止 工 作 
导致 用 户 无 法 访问 应 用 程序 之 前 ， 无 法 发 现 CDN 是 
否 失效 。 最 简单 的 检查 回 退 的 方式 是 将 src 属 性 指定 
的 文件 名 改 为 某 个 不 存在 的 文件 名 《可 在 文件 名 后 
追加 FAIL ) ， 然 后 使 用 F12 键 来 查看 浏览 器 的 网 络 
请 求 。 你 应 该 看 到 CDN 文 件 出 错 了 ， 后 面 跟着 对 回 
退 文 件 的 请 求 。 


1g 
Of 


CDN 回 退 特性 依赖 于 浏览 器 同步 加 载 和 执行 


script 元 素 ， 并 按照 定义 的 顺序 依次 执行 。 有 很 多 异 
步 处 理 技术 可 用 来 加 速 JavaScript 文 件 的 加 载 和 执 
行 ， 但 是 它们 将 导致 在 浏览 器 从 CDN 获 取 文 件 之 前 
执行 回 退 测试 ， 结 果 导 致 在 CDN 完 美工 作 时 ， 首 先 
淘汰 CDN 的 使 用 。 不 要 和 CDN 回 退 特 性 一 起 混用 异 
步 脚 本 加 载 。 








25.3.2 ”管理 CSS 样 式 表 


LinkTagHelper 类 是 内 置 的 作用 于 link 元 素 的 标 
签 助 手 ， 用 来 官 理 视图 中 包含 的 CSS。 该 标签 助手 
文 持 的 属性 如 表 25-4 所 示 。 


表 25-4 用 于 link 元 素 的 内 置 标签 助手 类 定义 的 属性 























8 元 素 的 href 属 性 选择 文件 











asp-href-exclude 用 于 为 输出 元 素 的 href 属 性 排除 文件 











asp-append-version 用 于 启用 缓存 清除 




















asp-fallback-href 用 于 在 CDN 出 现 问题 时 指定 回 退 文件 








asp-fallback-href-include 用 于 在 CDN 出 现 问 题 时 选择 将 要 使 用 的 文件 





asp-fallback-href-exclude 用 于 在 CDN 出 现 问 题 时 选择 将 被 排除 的 文件 





asp-fallback-href-test-class 用 于 指定 测试 CDN 的 CSS 类 名 


asp-fallback-href-test-property 用 于 指定 测试 CDN 的 CSS 属 性 





asp-fallback-href-test-value 用 于 指定 测试 CDN 的 CSS 值 





1. 选择 样式 表 


LinkTagHelper 与 ScriptTagHelper 文 持 许多 相同 
的 特性 ， 包 括 文 持 使 用 通配符 选择 或 排除 CSS 文 
件 ， 所 以 不 必 单 个 指定 。 能 够 准确 选择 CSS 文 件 与 
选择 JavaScript 文 件 一 样 重要 ， 因 为 样式 表 文 件 也 有 
第 规 和 去 绾 版 本 ， 同 样 文 持 源 码 映 射 。 对 于 流行 的 





Bootstrap, KE- EAN EREIZ. ~wwwroot/ 
lib/bootstrap/distycss 文 件 夹 中 包含 一 些 样式 表 文 件 ， 
如 果 在 Solution Explorer 窗 格 中 展开 所 有 的 项 目 ， 你 
将 看 到 多 个 文件 ， 如 图 25-5 所 示 。 





图 25-5 ”多 个 文件 


文件 boostrap.css 表 示 第 规 样式 表 ， 文 件 
boostrap.min.css 表 示 紧 缩 版 本 ， 文 件 
bootstrap.css.map 表 示 源 人 码 映射 ， 这 里 的 其 他 文件 用 
于 提供 特定 功能 ， 但 本 章 并 不 涉及 。 代 码 清单 25- 


11 使 用 link 元 素 的 asp-href-include 属 性 来 选择 紧缩 版 
本 的 样式 表 〈 还 删除 了 加 载 jQuery 的 Script 元 素 ， 
为 这 里 已 不 再 需要 ) 。 





代码 清单 25-11 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 选择 样式 表 


<!DOCTYPE html> 
<html> 
<head> 

<meta name="viewport" content="width=device-width" 
/> 

<title>Cities</title> 

<link rel="stylesheet" 

asp-href-include="/1ib/bootstrap/dist/**/*.mi 

n.css" 


asp-href-exclude="**/*-reboot*, **/*-grid*"/> 


</head> 

<body class="m-1 p-1"> 
<div>@RenderBody()</div> 

</body> 

</html> 





在 选择 JavaScript 文 件 时 同样 需要 注意 细 市 ， 
为 很 容易 非 你 所 愿 地 生成 用 于 选择 多 个 同样 文件 的 
不 同 厂 本 的 link 元 素 。 选 择 JavaScript 文 件 有 3 种 方 





式 : 限制 通配符 ， 使 用 asp-href-exclude 属 性 排除 文 
件 ， 使 用 environment 元 素 在 重复 的 元 素 集合 中 进行 


选择 。 








2. 使 用 CDN 


LinkTag 类 提供 了 一 系列 属性 用 于 在 CDN 失 效 
时 提供 到 本 地 内 容 的 回 退 控制 ， 但 测试 样式 表 是 否 
加 载 的 过 程 相 比 JavaScript 文 件 有 一 点 复杂 。 代 人 码 清 
单 25-12 使 用 MaxCDN UREL 来 加 载 Bootstrap 库 ， 这 
仅仅 用 来 展示 微软 平台 之 外 的 另 一 个 选择 
(MaxCDN 是 Bootstrap 项 目 推荐 的 CDN) 。 





代码 清单 25-12 EViews/Shared XF% F HJ_Layout.cshtml X 
件 中 使 用 CDN 加 载 CSS 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Cities</title> 


<link href="*****;//maxcdn.bootstrapcdn. ***/bootstr 
ap/4.0.0-alpha.6/css/bootstrap.min.css" 
asp-fallback-href-include="/1ib/bootstrap/dis 
t/**/* .min.css" 
asp-fallback-href-exclude="**/*-reboot*, **/*- 


grid*" 
asp-fallback-test-class="btn" 
asp-fallback-test-property="display" 
asp-fallback-test-value="inline-block" 
rel="stylesheet" /> 

</head> 


<body class="m-1 p-1"> 
<div>@RenderBody()</div> 

</body> 

</html> 





属性 href 用 于 指定 CDN 地 址 ， 这 里 还 使 用 asp- 
fallback-href-include 属 性 来 选择 在 CDN 不 可 用 时 将 
被 使 用 的 文件 。 为 了 测试 CDN 是 否 工 作 ， 需 要 使 用 
3 个 不 同 的 属性 ， 并 理解 所 使 用 的 CSS 样 式 表 定义 的 
CSS 类 。 





CSS 回 退 特性 通过 为 文档 添加 meta 元 素 而 起 作 
用 ， 其 由 asp-fallback-test-class 属 性 定义 的 类 添加 。 
以 上 代码 指定 了 btn 类 ， 这 意味 痢 如 下 元 系 将 被 添加 





到 发 送 到 浏览 嚣 的 HIML 中: 





<meta name="x-stylesheet-fallback-test" class="btn" /> 


指定 的 CSS 类 必须 在 通过 CDN 加 载 的 样式 表 中 
定义 。 这 里 指定 的 btn 类 为 Bootstrap 按 钮 元 素 提供 基 
本 的 格式 化 。 








属性 asp-fallback-test-property 用 于 指定 由 CSS 类 
定义 的 属性 ， 属 性 asp-fallback-test-value 用 于 指定 将 
梓 设 置 的 值 。 标 签 助手 会 添加 JavaScript 到 视 风 中 以 
测试 meta 元 素 中 的 CSS 属 性 值 ， 从 而 确定 样式 表 是 
TRIER. FFA MIRAE, RATER CPPS 
link 元 素 。Bootstrap 的 btmn 类 已 设置 display 属 性 为 
inline-block, Mitt Wins? Ail bias ce n He CDN 
加 载 Bootstrap 样 式 表 。 











人 
提 示 


要 测试 第 三 方 库 ， 比 如 Bootstrap， 最 简单 的 方 
法 是 按 F12 键 。 为 检验 代码 清单 25-12 中 的 测试 ， 为 
按钮 指定 btn 类 ， 然 后 在 浏览 历 中 检 耕 ， 答 看 类 修改 
的 CSS 属 性 ， 这 比试 图 阅读 长 且 复 杂 的 样式 表 要 容 


J o 


25.4 使 用 超 链 接 元 素 


超 链 接 元 素 a 是 在 应 用 程序 中 进行 导航 的 基本 
工具 ， 可 通过 发 送 GET 请 求 到 应 用 程序 来 请 求 不 同 
的 内 容 。AnchorTagHelper 关 用 于 转换 a 元 素 的 Pref 
属性 以 便 使 用 路 由 系统 生成 指 回 的 URL 地 址 。 该 标 





丛 助 手 文 持 的 属性 如 表 25-5 所 示 。 


表 25-5 ”用 于 超 链接 元 素 的 内 置 标签 助手 类 定义 的 属性 


指定 URL 指 向 的 操作 方法 


asp- 





























指定 URL 指 向 的 控制 器 


controller 


punea 
acpi ~ Po A 

用 于 指定 URL 片 段 〈 在 # 字 符 之 后 应 用 ) 
fragment 





指定 URL 指 向 的 主机 名 


asp- 
~ 指定 URL 使 用 
protocol 
指定 用 于 生成 URL 的 路 由 名 称 


asp-route- | 以 asp-route- 开 头 的 属性 用 于 指定 URL 附 加 值 ， 例 如 asp-route-id 属 性 
由 系统 中 id 片段 的 值 







































































AnchorTagHelper 人 简单 且 可 了 预测， 使 得 使 用 应 
用 程序 的 路 由 系统 在 a 元 又 中 生成 URL 变 得 容易 。 
代码 清单 25-13 更 新 了 Index.cshtml 文 件 中 的 a 元 素 ， 
以 便 其 href 属 性 由 标签 助手 生成 。 











代码 清单 25-13 ”在 Views/Home 文 件 夹 下 的 Pmdex.cshtml 文 件 中 
转换 超 链接 元 素 





@model IEnumerable<City> 


@{ Layout = " Layout"; } 


<table class="table table-sm table-bordered"> 
<thead class="bg-primary text-white"> 
<tr> 
<th>Name</th> 
<th>Country</th> 
<th class="text-right">Population</th> 
</tr> 
</thead> 
<tbody> 
@foreach (var city in Model) { 
<tr> 
<td>@city .Name</td> 
<td>@city.Country</td> 
<td class="text-right">@city.Population 
?. TOString ("#, ###")</td> 
</tr> 


} 


</tbody> 
</table> 
<a asp-action="Create" class="btn btn-primary">Create</ 
a> 





如 果 运 行 应 用 程序 并 访问 /Home/Index， 你 将 
看 到 标签 助手 将 a 元 素 转换 为 如 下 形式 : 


<a class="btn btn-primary“ href="/Home/Create">Create</ 


a> 





25.5 ”使 用 图 像 元 系 


ImageTagHelper 类 用 于 通过 img 元 素 的 src 属 性 
为 图 片 提供 缓存 清除 功能 ， 在 确保 对 图 片 的 修改 能 
够 立即 得 到 反馈 的 同时 ， 允 许 应 用 程序 获得 缓存 的 
好 处 。 可 使 用 img 元 素 的 asp-append-version 属 性 启 
用 绥 存 清除 功能 。 














代码 清单 25-14 在 共享 布 局 中 添加 了 一 个 img 元 
素 〈( 为 了 简化， 可 以 重 置 style 元 素 以 便 使 用 本 地 文 





HE) 


代码 清单 25-14 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 添加 图 三 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 
<title>Cities</title> 
<link href="https://maxcdn.bootstrapcdn.com/bootstr 
ap/4.0.0-alpha.6/css/bootstrap.min.css" 
asp-fallback-href-include="/lib/bootstrap/dis 
t/**/*.min.css" 
asp-fallback-href-exclude="**/*-reboot*,**/*- 
grid*" 
asp-fallback-test-class="btn" 
asp-fallback-test-property="display" 
asp-fallback-test-value="inline-block" 
rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
<img src="/images/city.png" asp-append-version="tru 
e" /> 
<div>@RenderBody()</div> 
</body> 
</html> 
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页 面 的 项 部。 如 果 检 查 友 送 到 浏览 器 的 HTML， 你 
将 看 到 用 于 请 求 图 片 文 件 的 URL 包 含 了 版 本 校 验 
和 ， 如 下 上 所 示 : 





与 JavaScript 和 CSS 样 式 表 的 缓存 清除 类 似 ， 包 





售 在 URL 中 的 校 验 和 将 保持 不 变 ， 直 到 文件 和 修改 
为 止 。 


25.6 ”使 用 数据 缓存 


MVC 包 含 的 内 存 缓存 用 于 缓存 内 容 片 段 以 便 
加 速 视图 的 演 染 。 补 缓存 的 内 容 使 用 视图 中 的 cache 
元 素 指定 ， 由 CacheTagHelper 类 使 用 表 25-6 所 示 的 
属性 处 理 。 
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YY EA 
ye Je. 








绥 存 是 重用 和 内容 段 落 的 有 用 工具 ， 以 便 它 们 不 
为 每 次 请 求生 成 一 次 。 但 是 ， 使 用 缓存 事实 上 
ee 绥 存 可 以 改进 应 用 程序 的 性 

E， 也 会 导致 奇怪 的 效 末 ， 比 如 用 户 收 到 过 时 的 内 
容 ， La A BURA, eS, A 
应 用 程序 缓存 的 前 一 个 版 本 的 内 容 与 新 版 本 的 内 容 
混杂 在 一 起 会 寻 致 更 新 部 普 和 "中断 。 除 非 清晰 定义 
了 要 解雇 的 性 能 问题 ， 并 确认 理解 缓存 将 导致 的 影 
啊 ， 人 否则 不 要 局 用 缓存 。 





= 
a 
= 
Pi 








表 25-6 用 于 cache 元 素 的 内 置 标签 助手 类 定义 的 属性 


属性 描述 























enabled 目 于 控制 cache 元 素 的 内 容 是 否 被 缓存 ， 若 省 略 ， 表 示 启 用 缓存 


于 指定 缓存 内 容 的 绝对 过 期 时 间 ， 表 达 式 为 DateTime 值 
] 于 指定 缓存 内 容 过 期 的 相对 时 间 ， 表 达 式 为 TimeSpan 值 


] 于 指定 当 缓 存 内 容 过 期 时 ， 从 最 后 使 用 开始 的 区 间 ， 表 达 式 为 TimeSpan 值 











> 



































































































































-by- 
| 青 求 头 的 名 称 ， 它 将 用 于 管理 不 同 版 本 的 缓存 内 容 
header 

-by- 
于 指定 查询 串 的 键 ， 它 将 用 于 管理 不 同 版 本 的 缓存 内 
query 













































































-b 
于 指定 路 由 变量 的 名 称 ， 它 将 用 于 管理 不 同 版 本 的 缓存 内 容 
route 

-by- 
] 于 指定 Cookie 的 名 称 ， 它 将 用 于 管理 不 同 版 本 的 缓存 内 容 
cookie 


vary-by-user | 用 i 验证 用 户 的 名 称 ， 它 将 用 里 不 同 版 本 的 缓存 内 容 


j 于 提供 管理 不 同 版 本 缓存 内 容 的 键 值 


用 于 指定 相对 优先 级 ， 在 内 存 缓存 耗 尽 并 清理 未 过 期 缓存 内 容 时 ， 该 属性 的 
Fin) RO 











































































































































































































priority 











为 了 演示 cache 属 性 的 操作 方式 ， 创 建 
Components XFX, FIMEN 
TimeViewComponent.cs 的 类 文件 ， 用 它 定 义 代码 清 
单 25-15 所 示 的 视图 组 件 。 


代码 清单 25-15” Components 文 件 夹 下 的 
TimeViewComponent.cs 文 件 的 内 容 


using System; 
using Microsoft.AspNetCore.Mvc; 


namespace Cities.Components { 


public class TimeViewComponent : ViewComponent { 


public IViewComponentResult Invoke() { 
return View(DateTime.Now) ; 





Invoke 方 法 使 用 默认 视图 ， 并 提供 DateTime 对 
象 作 为 视图 模型 。 为 了 给 视图 组 件 提 供 视 图 ， 创 建 
Views/Home/Components/Time 文 件 夹 ， 添 加 名 为 


Default.cshtml 的 视图 文件 ， 内 容 如 代码 清单 25-16 所 
TI 


代码 清单 25-16 ”Views/Home/Components/Time 文 件 夹 下 的 
Default.cshtml 文 件 的 内 容 


@model DateTime 


<div class="m-1 p-1 bg-info text-white"> 
Rendered at @Model.ToString("HH:mm:ss") 
</div> 











DateTime 模 型 对 象 用 于 显示 当前 时 间 ， 人 准确 到 
秒 。 代 码 清 单 25-17 已 将 25.5 节 的 img 元 素 蔡 换 为 
@await Component.InvokeAsync 表 达 式 以 调用 视图 
组 件 。 


代码 清单 25-17 在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 使 用 视图 组 件 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 


<title>Cities</title> 
<link href="https://maxcdn.bootstrapcdn.com/bootstr 
ap/4.0.0-alpha.6/css/bootstrap.min.css" 
asp-fallback-href-include="/lib/bootstrap/dis 
t/**/*.min.css" 
asp-fallback-href-exclude="**/*-reboot*,**/*- 


grid*" 
asp-fallback-test-class="btn" 
asp-fallback-test-property="display” 
asp-fallback-test-value="inline-block" 
rel="stylesheet" /> 

</head> 


<body class="m-1 p-1"> 
@await Component. InvokeAsync("Time" ) 
<div>@RenderBody()</div> 

</body> 

</html> 





如 果 运 行 应 用 程序 ， 你 将 看 到 标题 栏 显示 了 内 
容 泻 染 的 时 间 。 等 待 几 秒 后 重新 加 载 页 面 ， 你 将 看 
到 显示 的 时 间 发 生 了 变化 ， 如 图 25-6 所 示 。 





Population 


New York London UK 8,539,000 


ES a ae pa T a 





图 25-6 ”在 示例 应 用 中 显示 时 间 


Ju cache HA KIA BE BAS I BZ EAA 
容 。 人 代码 清 单 25-18 使 用 cache 元 素 将 视图 组 件 添 加 
到 了 绥 存 中 。 


代码 清单 25-18 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
TEP BEA A 








<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 
<title>Cities</title> 
< link href="https://maxcdn.bootstrapcdn.com/bootst 
rap/4.0.0-alpha.6/css/bootstrap.min.css" 
asp-fallback-href-include="/1ib/bootstrap/di 
st/**/*.min.css" 
asp-fallback-href-exclude="**/*-reboot* , **/* 
-grid*" 
asp-fallback-test-class="btn" 
asp-fallback-test-property="display" 
asp-fallback-test-value="inline-block" 
rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
<cache> 
@await Component. InvokeAsync("Time" ) 
</cache> 
<div>@RenderBody()</div> 
</body> 


</html> 


在 没有 任何 属性 的 情况 下 应 用 cache 元 素 会 使 
MVC 重 用 这 些 内 容 以 满足 所 有 未 来 的 请 求 。 如 果 局 
动 应 用 程序 ， 则 会 缓存 视 岁 组 件 生 成 的 内 容 ， 所 以 
即使 页 面 重 新 加 载 也 会 显示 同样 的 时 间 。 


o 
提 示 


CacheTagHelper 类 使 用 的 缓存 是 基于 内 和 存 的 ， 
这 意味 看 绥 存 容量 受 限 于 可 用 的 内 存 。 当 绥 存 容量 
短缺 的 时 候 ， 将 从 缓存 中 退出 内 容 ， 在 应 用 程序 集 
止 或 重启 时 ， 整 个 内 容 都 将 丢失 。 








25.6.1 设置 缓存 过 期 时 间 


属性 expires-* 允 许 指 定 内 容 何 时 过 期 ， 使 用 绝 
对 时 间 《 相 对 于 当前 时 间 而 言 ) 或 缓存 内 容 不 被 请 
求 的 区 间 来 表示 。 代 码 清 单 25-19 使 用 expires-after 
属性 指定 内 容 应 被 缓存 15s。 


代码 清单 25-19 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 设置 缓存 过 期 时 间 








<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Cities</title> 
<link href="https://maxcdn.bootstrapcdn.com/bootstr 
ap/4.0.0-alpha.6/css/bootstrap.min.css" 
asp-fallback-href-include="/lib/bootstrap/dis 
t/**/*.min.css" 
asp-fallback-href-exclude="**/*-reboot*,**/*- 


grid*" 
asp-fallback-test-class="btn" 
asp-fallback-test-property="display" 
asp-fallback-test-value="inline-block" 
rel="stylesheet" /> 

</head> 


<body class="m-1 p-1"> 


<cache expires-after="@TimeSpan.FromSeconds(15)"> 
@await Component. InvokeAsync( "Time" ) 
</cache> 
<div>@RenderBody()</div> 
</body> 
</html> 





如 果 运 行 应 用 程序 ， 你 将 看 到 缓存 的 数据 在 
15s 后 过 期 ， 重 新 加 载 页 面 后 将 调用 视图 组 件 ， 并 
创建 男 一 新 的 缓存 过 期 时 间 为 15s 的 条 目 





设置 固定 过 期 时 间 


可 以 使 用 expires-on 属 性 指定 固定 的 绥 存 内 容 过 
期 时 | 间 ， 该 属性 接收 一 个 DateTime 值 ， 如 代码 清单 
25-20 所 示 。 





代码 清单 25-20 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 中 
设置 固定 过 期 时 间 








<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 


<title>Cities</title> 
<link href="https://maxcdn.bootstrapcdn.com/bootstr 
ap/4.0.0-alpha.6/css/bootstrap.min.css" 
asp-fallback-href-include="/1lib/bootstrap/dis 
t/**/*.min.css" 
asp-fallback-href-exclude="**/*-reboot*, **/*- 


grid*" 
asp-fallback-test-class="btn" 
asp-fallback-test-property="display" 
asp-fallback-test-value="inline-block" 
rel="stylesheet" /> 

</head> 


<body class="m-1 p-1"> 
<cache expires-on="@DateTime.Parse("2100-01-01")"> 
@await Component. InvokeAsync( "Time" ) 
</cache> 
<div>@RenderBody()</div> 
</body> 
</html> 





以 上 代码 指定 数据 将 被 缓存 到 2100 年 。 由 于 应 
用 程序 很 可 能 在 22 世 纪 开始 前 重新 启动 ， 因 此 这 不 
是 什么 有 用 的 缓存 策略 ， 但 它 展示 了 在 内 容 被 缓存 
的 时 候 ， 如 何 指定 固定 的 未 来 时 间 ， 而 不 是 相对 于 
当前 时 刻 的 过 期 时 间 。 











2. 设置 最 后 使 用 绥 存 期 限 








属性 expires-sliding 用 于 指定 如 果 没 有 被 缓存 访 
间 过 ， 多 长 时 间 之 后 内 容 将 过 期 。 代 人 码 清单 25-21 
指定 过 期 时 间 为 10s。 





代码 清单 25-21 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 指定 最 后 使 用 缓存 期 限 

















<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 
<title>Cities</title> 
<link href="https://maxcdn.bootstrapcdn.com/bootstr 
ap/4.0.0-alpha.6/css/bootstrap.min.css" 
asp-fallback-href-include="/lib/bootstrap/dis 
t/**/*.min.css" 
asp-fallback-href-exclude="**/*-reboot*,**/*- 


grid*" 
asp-fallback-test-class="btn" 
asp-fallback-test-property="display" 
asp-fallback-test-value="inline-block" 
rel="stylesheet" /> 

</head> 


<body class="m-1 p-1"> 
<cache expires-sliding="@TimeSpan.FromSeconds(10)"> 
@await Component.InvokeAsync("Time") 
</cache> 
<div>@RenderBody()</div> 
</body> 


</html> 

WIS 77 MAHET eS EA, a 
以 看 到 express-sliding 属 性 的 效果 。 只 要 在 10s 内 重 
新 加 载 页 面 ， 绥 存 的 内 容 将 被 使 用 。 如 采 等 竺 的 时 
间 超 过 10s 并 重新 加 载 页 面 ， 那 么 缓存 的 内 容 将 被 
丢弃 ， 视 图 组 件 将 用 于 生成 新 的 内 容 ， 并 且 此 过 程 
将 重新 开始 。 


25.6.2 ”使 用 绥 存 变 体 


默认 情况 下 ， 所 有 请 求 接 收 相同 的 缓存 内 容 。 
CacheTagHelper 类 可 以 对 缓存 的 内 容 维护 多 种 不 同 
版 本 ， 并 使 用 它们 来 满足 不 同 种 类 的 HITP 请 求 ， 
使 用 名 称 以 不 同方 式 开 头 的 vary-by 属 性 之 一 进行 设 
置 即 可 。 代 码 清 单 25-22 展 示 了 如 何 使 用 vary-by- 
route 属 性 来 基于 路 由 系统 匹配 的 action 名 称 创建 组 
存 变 体 。 








代码 清单 25-22 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 创建 缓存 变 体 


<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Cities</title> 
<link href="https://maxcdn.bootstrapcdn.com/bootstr 
ap/4.0.0-alpha.6/css/bootstrap.min.css" 
asp-fallback-href-include="/lib/bootstrap/dis 
t/**/*.min.css" 
asp-fallback-href-exclude="**/*-reboot*,**/*- 
grid*" 
asp-fallback-test-class="btn" 
asp-fallback-test-property="display" 
asp-fallback-test-value="inline-block" 
rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
<cache expires-sliding="@TimeSpan.FromSeconds(10)" 
vary-by-route="action"> 
@await Component. InvokeAsync("Time" ) 
</cache> 
<div>@RenderBody()</div> 
</body> 
</html> 








WO RT MH EP HEH PS a a el FR 
问 /HHome/Index 和 /Home/Create， 你 将 看 到 每 个 窗口 








接收 各 上 自 的 绥 存 内 容 ， 因 为 每 个 请 求 会 处 理 不 同 的 
action 路 由 值 。CacheTagHelper 类 文 持 不 同 变 体 的 一 
系列 属性 ， 包 括 为 单个 用 户 绥 存 内 容 。 





vary-by 请 求 头 允许 使 用 任何 数据 值 定 义 任意 绥 
存 变 体 。 代 码 清 单 25-23 通 过 指定 直接 从 路 由 数据 
中 提取 的 值 再 现 了 vary-by-route 属 性 的 效果 。 








代码 清单 25-23 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 指定 自 定 义 的 缓存 变 体 








<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 
<title>Cities</title> 
<link href="https://maxcdn.bootstrapcdn.com/bootstr 
ap/4.0.0-alpha.6/css/bootstrap.min.css" 
asp-fallback-href-include="/lib/bootstrap/dis 
t/**/*.min.css" 
asp-fallback-href-exclude="**/*-reboot*,**/*- 
grid*" 
asp-fallback-test-class="btn" 
asp-fallback-test-property="display" 
asp-fallback-test-value="inline-block" 
rel="stylesheet" /> 


</head> 
<body class="m-1 p-1"> 
<cache expires-sliding="@TimeSpan.FromSeconds(10)" 
vary-by="@ViewContext.RouteData.Values[ "acti 


on"]"> 
@await Component. InvokeAsync( "Time" ) 
</cache> 
<div>@RenderBody()</div> 
</body> 
</html> 





属性 vary-by 可 以 用 于 创建 更 复杂 的 绥 存 变 体 ， 
应 该 尽量 慎 用 ， 因 为 它 很 容易 失控 ， 导 致 创建 的 变 
体 如 此 特殊 ， 以 至 于 绥 存 的 内 容 在 过 期 前 永远 不 会 
WEH. 




















使 用 应 用 程序 相关 的 URL 


最 后 介绍 的 内 置 标签 助手 类 是 
UrlResolutionTagHelper， 用 于 对 应 用 程序 相关 的 
URL 提 供 支持 ， 它 们 是 以 ~ 字符 作为 前 级 的 URL，。 
代码 清单 25-24 修 改 了 共享 布局 中 的 link 元 素 以 便 使 
用 显 式 定 义 的 URL， 而 不 是 使 用 标签 助手 从 路 由 系 














统 生成 URL。 


代码 清单 25-24 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 使 用 显 式 定义 的 URL 


<!DOCTYPE html> 
<html> 
<head> 

<meta name="viewport" content="width=device-width" 
/> 

<title>Cities</title> 

<link href="/1lib/bootstrap/dist/css/bootstrap.min.c 
ss" rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 

<cache expires-sliding="@TimeSpan.FromSeconds(1@)" 

vary-by="@ViewContext.RouteData.Values[ "acti 

on" |] "> 


@await Component.InvokeAsync("Time") 
</cache> 
<div>@RenderBody()</div> 
</body> 
</html> 





显 却 的 URL 是 完全 可 以 接 有 党 的 ， 但 你 要 明日 ， 
如 果 更 新 应 用 程序 的 URL 和 架构 ， 你 将 不 得 不 更 新 它 
们 。 











但 是 ， 某 些 应 用 程序 将 被 部 普 到 共 孚 环境 中 ， 
单个 服务 器 通过 向 URL 添 加 前 绥 来 支持 多 个 应 用 程 
序 。 人 代码 请 单 25-25 修 改 了 应 用 程序 的 配置 ， 以 便 
将 请 求 管 线 设置 为 处 理 具 有 mvcpp 前 绥 的 请 求 ， 从 
而 模拟 共 宇 环境 。 











代码 清单 25-25 在 Cities 文 件 夹 下 的 Startup.cs 文 件 中 添加 URL 


前 绥 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using Cities.Models; 


namespace Cities { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<IRepository, MemoryRe 
pository>(); 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.Map("/mvcapp", appBuilder => { 
appBuilder.UseStatusCodePages() ; 
appBuilder .UseDeveloperExceptionPage() ; 
appBuilder.UseStaticFiles(); 
appBuilder .UseMvcWithDefaultRoute( ) ; 





Map 方 法 允许 使 用 不 同 的 前 缀 设置 多 个 请 求 管 
线 。 在 日 常 MVC 开 发 中 这 通常 不 是 什么 有 用 的 功 
能 ， 因 为 可 以 使 用 路 由 系统 在 MVC 应 用 程序 内 创建 
URL 前 级 。 但 对 于 本 章 ， 这 是 一 个 十 分 有 用 的 特 
性 ， 因 为 它 意 味 着 被 客户 端 请 求 的 任何 UREL 将 包括 
对 静态 内 容 的 请 求 。 











通过 运行 应 用 程序 并 访问 /mvcapp《〈 访 地 址 现 
在 是 应 用 程序 的 默认 地 址 ， 并 且 指 向 Home 控 制 器 
的 Index 操 作 方 法 ) ， 你 可 以 查看 出 现 的 问题 。 现 在 
所 有 的 URL 都 以 /mvcapp 开 始 ， 对 于 link 元 素 内 的 样 





式 表 ， 显 式 的 URL 不 起 作用 ， 这 意味 着 应 用 程序 的 
内 容 不 能 被 修饰 ， 如 图 25-7 所 示 。 





San Jose USA 998,537 
Paris France 2,244,000 
Create 





图 25-7 显 式 定义 URL 的 效果 


通过 在 URL 中 包含 这 个 前 级 ， 你 可 以 解决 该 问 
题 ， 但 是 因为 前 级 可 能 在 部 署 时 更 新 或 在 开发 时 不 
知道 ， 这 种 方案 并 不 可 行 。 更 好 的 方案 是 使 用 应 用 
程序 相关 的 URL， 这 样 静 态 内 容 的 路 径 束 可 以 表示 
为 相对 于 已 配置 的 任何 前 级 ， 如 代码 消音 25-26 所 
不 。 











代码 清单 25-26 ”在 Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 
件 中 使 用 应 用 程序 的 相对 URL 





<!DOCTYPE html> 
<html> 
<head> 
<meta name="viewport" content="width=device-width" 


/> 

<title>Cities</title> 

<link href="~/1ib/bootstrap/dist/css/bootstrap.min. 
css" rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 

<cache expires-sliding="@TimeSpan.FromSeconds(1@)" 

vary-by="@ViewContext.RouteData.Values[ "acti 
on" |"> 
@await Component. InvokeAsync("Time" ) 

</cache> 

<div>@RenderBody()</div> 
</body> 
</html> 





5 Al 


~ 符号 由 UrlResolutionTagHelper 检 测 ， 将 ~ 符号 
符 换 为 到 达 wwwroot 文 件 夹 内 容 所 需 的 路 径 。 如 采 
运行 应 用 程序 ， 你 将 看 到 内 容 被 修饰 了 了， 检查 及 送 
到 浏览 硕 的 HTML 内 容 ， 你 将 看 到 link 元 系 包 含 了 
使 用 mvcapp 前 级 的 URL: 








<link href="/mvcapp/lib/bootstrap/dist/css/bootstrap.mi 





n.css" rel="stylesheet" /> 


UrlResolutionTaghelper 能 在 各 种 元 素 中 得 询 
URL， 如 表 25-7 所 示 。 





表 25-7 可 由 UrlResolutionTagHelper 转 换 的 元 素 及 其 属性 








form action 





src 和 formaction 





p 
提 示 


如 果 使 用 男 一 种 内 置 的 标签 助手 从 路 由 系统 生 
成 URL， 那 么 生成 的 HTML 将 自动 包括 任何 必要 的 


用 级 ， 这 是 从 HttpRequest.PathBase 上下文 属 性 中 获 
取 的 ， 并 且 值 由 宿主 应 用 程序 的 服务 器 提供 。 


25.7 小结 


本 章 介 绍 了 除了 表单 标签 助手 之 外 的 内 置 标签 
助手 。 这 些 标签 助手 用 于 帮助 管理 对 JavaScript 文 件 
和 CSS 样 式 表 文件 的 访问 ， 为 超 链接 元 素 创 建 
URL， 为 图 片 执行 绥 存 清理， 绥 存 数据 ， 以 及 转换 





与 应 用 程序 相关 的 URL， 等 等 。 下 一 章 将 介绍 模型 
绑 定 ， 用 于 处 理 HTTP 请 求 中 的 数据 ， 以 便 数据 可 
以 在 MVC 应 用 程序 内 部 轻松 使 用 。 
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模型 绑 定 是 使 用 HTTP 请 求 中 的 数据 来 创 
建 .NET 对 象 的 过 程 ， 以 便 为 操作 方法 捉 供 需要 的 参 
数 。 本 章 将 拉 述 模型 绑 定 的 工作 方式 ， 展 示 模 型 绑 
定 如 何 绑 定 简单 类 型 、 复 杂 类 型 以 及 集合 ， 并 演示 
如 何 控制 绑 定 过 程 来 指定 将 请 求 的 哪 一 部 分 作为 操 
作 方 法 要 求 的 值 。 表 26-1 介 绍 了 模型 绑 定 的 背景 。 











表 26-1 模型 绑 定 的 背景 














模型 绑 定 是 | 模型 绑 定 是 使 用 HTTP 请 求 中 的 数据 来 创建 .NET 对 象 的 过 程 ， 以 便 为 操作 方 
什么 ? 法 提供 需要 的 参数 


























模型 绑 定 有 | 模型 绑 定 允许 操作 方法 使 用 C# 关 型 来 定义 参数 ， 参 数 可 自动 从 请 求 中 接收 数 























据 ， 而 不 需要 直接 检查 、 解 析 和 处 理 请 求 数据 























对 于 最 简单 的 场景 ， 操 作 方法 会 定义 参数 ， 参 数 名 称 用 来 从 HTTP 请 求 中 抽 
如 何 使 用 模 | 取 数 据 。 可 以 通过 对 操作 方法 的 参数 应 用 特性 来 配置 请 求 的 哪 一 部 分 用 于 数 





















































型 绑 定 ? 据 抽 取 




















模型 绑 定 有 
主要 的 陷阱 是 从 请 求 的 错误 部 分 获取 数据 。26.2 节 将 阐述 用 于 搜索 请 求 数 


何 陷阱 或 限 


制 ? 












































的 方式 ， 搜 索 的 位 置 可 以 使 用 特性 显 式 指定 









































模型 绑 定 有 | 操作 方法 可 以 完全 不 需要 声明 参数 ， 可 以 使 用 上 下 文 对 象 直接 从 HTTP 请 求 
何 蔡 代 品 ?| 对象 中 获取 数据 。 但 是 ， 代 码 更 复杂 ， 且 难以 理解 和 维护 






























































表 26-2 列 出 了 本 章 要 介绍 的 操作 。 


表 26-2 本章 要 介绍 的 操作 




















代码 清单 26-1 一 代码 清单 26-10 
为 操作 方法 添加 参数 和 代码 清单 26-23 一 代码 清单 26- 
29 

























































































角 认 视图 生成 的 HTMEL 是 结构 良好 的 代码 清单 26-11 一 代码 清单 26-19 





























选择 绑 定 “| 使 用 Bind 特 性 指定 数据 值 的 名 称 ， 或 者 使 用 
属性 BindNever 特 性 从 绑 定 过 程 中 排除 模型 属性 




















代码 清单 26-20 一 代码 清单 26-22 



































间 定 数据 
绑 定 值 的 为 操作 方法 的 参数 或 模型 属性 应 用 特性 ， 标 











代码 清单 26-30 一 代码 清单 26-38 











来 源 识 绑 定 值 应 该 来 自 何方 








26.1 准备 示例 项 目 





本 章 将 使 用 ASP.NET Core Web Application 
(NET Core) 模 板 创建 一 个 新 的 名 为 MvcModels 的 
Empty 项 目 。 


26.1.1 创建 模型 和 存储 库 


这 里 创建 Models 文 件 夹 ， 并 在 其 中 创建 名 为 
Person.cs 的 类 文件 ， 用 它 定义 代码 清单 26-1 所 示 的 
类 和 枚 举 。 


代码 清单 26-1 Models 文 件 夹 下 的 Person.cs 文 件 的 内 容 





using System; 


namespace MvcModels.Models { 


public class Person { 
public int PersonId { get; set; } 
public string FirstName { get; set; } 


public 


string LastName { get; set; } 


public DateTime BirthDate { get; set; } 
public Address HomeAddress { get; set; } 


public 
public 
} 


bool IsApproved { get; set; } 
Role Role { get; set; } 


public class Address { 


public 
public 
public 
public 
public 


} 


public enum Role { 
Admin, 
User, 
Guest 


string Line1 { get; set; } 
String Line2 { get; set; } 
string City { get; set; } 
string PostalCode { get; set; } 
string Country { get; set; } 





接着 ， 添 加 名 为 Repository.cs 的 类 文件 到 
Models 文 件 夹 中 以 定义 接口 和 实现 ， 如 代码 清单 


26-2 所 示 O 





代码 清单 26-2 Models 文 件 夹 下 的 Repository.cs 文 件 的 内 容 





using System.Collections.Generic; 


namespace MvcModels.Models { 


public interface IRepository { 
IEnumerable<Person> People { get; } 


Person this[int id] { get; set; } 
} 


public class MemoryRepository : IRepository { 
private Dictionary<int, Person> people 
= new Dictionary<int, Person> { 
[1] = new Person {PersonId = 1, FirstName = 


"Bob", 
LastName = "Smith", Role = Role.Admin}, 
[2] = new Person {PersonId = 2, FirstName = 
"Anne", 
LastName = "Douglas", Role = Role.User} 
3 
[3] = new Person {PersonId = 3, FirstName = 
"Joe", 
LastName = "Able", Role = Role.User}, 
[4] = new Person {PersonId = 4, FirstName = 
"Mary", 
LastName = "Peters", Role = Role.Guest} 
}; 
public IEnumerable<Person> People => people.Val 
ues; 
public Person this[int id] { 
get { 
return people.ContainsKey(id) ? people[ 
id] : null; 
} 
set { 
people[id] = value; 
} 


pe 
} 

IRepository 接 口 定 义 了 People 属性 来 获取 模型 
中 的 所 有 对 象 ， 还 定义 了 索 引 器 以 允许 获取 或 存储 
单个 对 象 。MemoryRepository 类 使 用 字典 实现 这 个 
接口 并 提供 了 一 些 默 认 内 容 。 这 个 存储 库 实 现 是 非 
持久 的 ， 所 以 在 应 用 停止 或 重新 启动 的 时 候 ， 应 用 
的 状态 将 和 被 重 置 。 

















26.1.2 ”创建 控制 需 和 视图 


XE G2 Controllers LFK, WIAA 
HomeController.cs 的 类 文件 ， 并 用 它 定 义 代码 清单 
26-3 所 示 的 控制 器 ee en ares LORIE ARB 
收 存 储 库 ， 在 Index 方 法 中 ， 通 过 PersonId 属 性 可 在 
存储 库 中 Rory 








代码 清单 26-3 Controllers X44% F HJ HomeController.cs X4 HY 
内 容 


using Microsoft.AspNetCore.Mvc; 
using MvcModels.Models; 


namespace MvcModels.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 


repository = repo; 


} 


public ViewResult Index(int id) => View(reposit 
ory[id]); 
} 


} 





为 了 给 操作 方法 提供 视图 ， 这 里 创建 
Views/Home 文 件 夹 ， 使 用 代码 清单 26-4 所 示 的 内 容 
在 其 中 琴 加 名 为 Index.cshtml 的 Razor 文 件 ， 将 模型 
对 象 的 一 些 属性 展示 在 表格 中 。 








代码 清单 26-4 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 的 内 


IP 


谷 





@model Person 
@{ Layout = " Layout"; } 


<div class="bg-primary m-1 p-1 text-white"><h2>Person</ 
h2></div> 


<table class="table table-sm table-bordered table-strip 
ed"> 
<tr><th>PersonId:</th><td>@Model.PersonId</td></tr> 
<tr><th>First Name:</th><td>@Model .FirstName</td></ 
tr> 
<tr><th>Last Name:</th><td>@Model.LastName</td></tr 
> 


<tr><th>Role:</th><td>@Model.Role</td></tr> 
</table> 





Index 视 图 基于 共享 布局 。 创 建 Views/Shared 文 
件 夹 ， 在 其 中 添加 名 为 _Layout.cshtml 的 布局 文件 ， 
内 容 如 代码 清单 26-5 所 示 。 


代码 清单 26-5 Views/Shared 文 件 严 下 的 _Layout.cshtml 文 件 的 
内 容 





<!DOCTYPE html> 
<html> 
<head> 

<meta name="viewport" content="width=device-width" 
/> 

<title>@ViewBag.Title</title> 

<link asp-href-include="/1lib/bootstrap/dist/**/*.mi 
n.css" rel="stylesheet" /> 

@RenderSection("scripts", false) 
</head> 


<body class="m-1 p-1"> 
@RenderBody() 

</body> 

</html> 





以 上 布局 包含 用 于 Bootstrap 样 式 表 的 link 元 素 
并 且 泻 染 视图 内 容 ， 还 包含 可 选 的 Scripts 部 分 
(section) ， 本 章 的 后 面 将 会 用 到 。 为 了 简化 本 章 
用 到 的 视图 ， 在 Views 文 件 夹 的 _ViewImports.cshtml 
文件 中 添加 包含 模型 类 的 命名 空间 ， 如 代码 清单 
26-6 所 示 。 








代码 清单 26-6 ”在 Views 文 件 夹 下 的 _ViewImports.cshtml 文 件 中 
导入 命名 空间 


@using MvcModels.Models 
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 


视图 基于 Bootstrap CSS 框架。 下面 使 用 Bower 
Configuration File 模 板 ， 在 项 目的 根 目录 中 创建 
bower.json 文 件 ， 将 Bootstrap 榨 加 到 项 目 中 。 榨 加 
的 包 如 代码 清单 26-7 所 示 。 


代码 清单 26-7 在 MvcModels 文 件 夹 下 的 bower.json 文 件 中 添加 
Bootstrap 包 
{ 


"name": "asp.net", 
"private": true, 


"dependencies": { 
"bootstrap": "4.0.0-alpha.6" 
} 





} 


26.1.3 配置 应 用 


为 了 初始 化 示例 应 用 ， 在 Startup 类 中 局 用 MVC 
框架 和 开发 中 用 到 的 其 他 中 间 件 ， 如 代码 清单 26-8 
所 示 。 这 里 还 为 存储 库 创 建 了 服务 以 便 控制 器 可 以 
访问 数据 模型 。 


代码 清单 26-8 MvcModels 文 件 夹 下 的 Startup.cs 文 件 的 内 容 





using System; 

using System.Collections.Generic; 
using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 
using Microsoft.AspNetCore.Hosting; 


using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using MvcModels.Models; 

namespace MvcModels { 


public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<IRepository, MemoryRe 
pository>(); 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvc (routes => { 
routes .MapRoute( 
name: "default", 
template: "{controller=Home}/{actio 


n=Index}/{id?}"); 
}); 





启动 应 用 并 访问 /Home/Index/1， 将 生成 图 26-1 
所 示 的 结果 。 现 在 ， 默 认 的 URL 地 址 将 导致 错误 。 





Admin 


图 26-1 运行 示例 应 用 
26.2 ”理解 模型 绑 定 


模型 绑 定 是 HTTP 请 求 与 C# 操 作 方 法 之 间 优 雅 
的 桥 染 。 多 数 MVC 应 用 在 某 种 程度 上 依赖 模型 绑 
定 ， 包 括 本 章 的 示例 应 用 。 前 面 在 测试 示例 应 用 的 
时 候 ， 模 型 绑 定 就 被 应 用 了 。 请 求 的 URL 中 包含 了 
希望 租 阅 的 Person 对 象 的 PersonId 属 性 值 ， 如 下 所 


ZN: 


/Home/Index/1 


MVC 对 这 一 部 分 URL 进 行 转 换 ， 并 且 在 调用 
Home 控 制 器 的 mdex 方 法 以 服务 请 求 的 时 候 将 之 作 


public ViewResult Index(int id) => View(repository[id]) 





为 了 调用 Index 方 法 ，MVC 需 要 一 个 值 作 为 id 
参数 ， 提 供 这 个 值 就 是 模型 绑 定 系统 的 责任 ， 模 型 
绑 定 系统 负责 为 调用 操作 方法 提供 数据 。 





模型 绑 定 基于 模型 绑 定 右 ， 模 型 绑 定 噩 的 职员 
是 从 请 求 的 条 个 部 分 或 应 用 本 里 提供 数据 。 上 默认 的 
模型 绑 定 从 3 个 方面 捉 供 数据 : 
。 表 单数 据 ; 


。 路 由 变量 ; 
。 HWA. 


每 个 数据 源 按照 顺序 被 检查 ， 下 到 参数 的 值 被 
友 现 。 示 例 应 用 中 没有 表单 数据 ， 所 以 也 就 不 用 从 


表单 中 进行 查找 。 但 是 ， 应 用 的 配置 中 包含 名 为 id 
的 路 由 片段 ， 因 而 允许 模型 绑 定 系统 提供 用 于 调用 
Idex 方 法 的 值 。 搜 索 在 发 现 合适 的 值 之 后 就 会 售 
止 ， 这 意味 着 查询 串 不 会 用 来 搜索 数据 。 





人 
提 示 


26.3 让 将 说 明 如 何 使 用 特性 来 指定 模型 绑 定 的 
数据 源 。 这 将 允许 从 指定 的 数据 源 获取 数据 ， 例 如 
查询 串 ， 即 使 表单 或 路 由 数据 中 存在 合适 的 数据 。 


知道 数据 的 搜索 顺序 很 重要 ， 因 为 请 求 中 可 能 
包含 多 个 值 ， 比 如 下 面 这 个 URL: 


/Home/Index/3?id=1 


PR EH RAR ACh EL ey OK FF VL CURL RAK HE id Fr 
段 为 9， 奉 询 串 中 包含 id 为 1 的 值 。 由 于 路 由 系统 在 
查询 串 之 前 搜索 数据 ，Index 方 法 将 收 到 值 3， 查 询 
P AERA A E o 











HAN E 查询 串 将 
会 被 处 理 ， 这 意味 着 这 样 的 UREL 也 人 允许 模型 绑 定 系 
统 为 MVC 提 供 id 值 ， 以 便 调 用 Index 方法 。 


/Home/Index?id=1 


图 26-2 显 示 了 这 两 种 URL 的 结果 。 








图 26-2 ”数据 源 次 序 对 模型 绑 定 的 影 啊 


26.2.1 默认 绑 定 值 


模型 绑 定 是 尽力 而 为 的 特性 ， 这 意味 看 MVC 
将 使 用 便 型 绑 定 来 试 痢 获取 调用 操作 方法 所 需 的 
值 ， 但 是 在 值 不 能 提供 时 也 仍然 调用 操作 方法 ， 这 
可 能 导致 一 些 意 想 不 到 的 行为 。 例 如 ， 访 
[+] /Home/Index 4 21 126-3 AT AS HY FF o 








mes pm Not ee an J 


图 26-3 ”异常 


图 26-3 所 示 的 寞 第 不 是 由 模型 绑 定 系统 报告 
的 。 当 处 理由 Index 方 法 选择 的 Index 视 图 时 ， 该 异 
常 出 现 。 为 了 调用 Index 方 法 ，MVC 不 得 不 为 id 参 
数 提供 值 ， 所 以 MVC 请 求 每 个 模型 绑 定 器 检查 各 日 











的 部 分 来 所 供 值 。 


T 没有 id 路 由 卢 段 ，URL 
中 也 没有 查询 串 ， 这 意味 着 模型 绑 定 不 能 提供 值 ， 
MVC 必 须 为 id 参数 提供 茶 些 值 来 调用 Index 方 法 ， 
MVC 使 用 了 默认 值 并 期 望 这 是 最 好 的 。 对 于 int 类 
型 参数 ， 默 认 值 是 0， 这 就 是 导致 寞 党 的 原因 。 在 
Index 方 法 的 定义 中 ， 使 用 id 参数 的 值 从 存储 库 中 获 
取 模 型 对 象 。 

















public ViewResult Index(int id) => View(repository[id]) 





当 MVC 使 用 默认 值 时 ， 操 作 方 法 试图 使 用 id 参 
数值 0 来 获取 数据 对 象 。 没 有 这 样 的 对 象 ， 存 储 库 
返回 null， 这 个 结果 随后 被 传递 给 控制 器 的 View 方 
法 以 为 ndex.cshtml 文 件 提供 视图 模型 对 象 。 当 
Index.cshtml 文 件 中 的 Razor 表 达 式 试图 访问 视图 模 








型 对 象 的 属性 时 ， 束 会 叶 致 图 26-3 所 示 的 


NullReferenceException 寞 澡 。 





这 意味 着 操作 方法 必须 应 对 模型 绑 定 系统 提供 
的 默认 值 。 这 可 以 通过 多 种 方式 来 完成 。 可 以 添加 
SAVE E| URL 路 由 模板 中 ， 为 操作 方法 提供 默认 
参数 ， 或 者 确保 操作 方法 不 会 将 错误 值 作 为 一 部 分 
传递 给 啊 应 。 最 好 的 处 理 方式 取决 于 操作 方法 做 什 
么 : 代码 清单 26-9 采用 了 最 后 一 种 方式 ， 修 改 操 
作 方 法 以 确保 一 个 Person 对 象 总 是 能 传递 给 View 方 
法 ， 即 使 id 参 数 并 不 对 应 数据 模型 中 的 对 象 。 








代码 清单 26-9 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 防范 默认 的 模型 绑 定 值 





using Microsoft.AspNetCore.Mvc; 
using MvcModels.Models; 
using System.Ling; 


namespace MvcModels.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 
} 


public ViewResult Index(int id) => 
View(repository[id] ?? repository.People.Fi 





当 使 用 id 参数 的 值 不 能 取 回 对 象 的 时 候 ， 操 作 
方法 使 用 LINQ 和 null 合 并 操作 符 来 返回 存储 库 中 的 
第 一 个 对 象 


26.2.2 ” 绑 定 简单 值 


当 有 合适 的 值 可 用 时 ， 该 值 必须 被 转换 为 C# 
值 ， 以 便 可 以 用 于 调用 操作 方法 。 使 用 请 求 中 的 简 
单 类 型 可 以 从 字符 串 中 解析 得 到 数据 项 ， 包 括 数 
值 、 布 尔 值 、 日 期 以 及 字符 串 值 。 





Index 方 法 的 id 参数 为 int 类 型 ， 所 以 模型 绑 定 过 
程 通 过 将 id 片段 解析 为 整数 值 提供 给 MVC。 


如 果 请 求 值 不 能 被 转换 例如， 提供 apple 给 需 
要 int 类 型 值 的 参数 ) ， 醒 型 绑 定 系统 将 不 能 为 应 用 
程序 提供 值 ， 默 认 值 将 会 被 使 用 。 





这 会 出 现 问 题 ， 因 为 在 两 种 情况 下 操作 方法 部 
将 收 到 默认 值 0。 第 一 种 情况 是 ， 请 求 中 包含 不 能 
被 解析 为 参数 类 型 的 值 ， 如 URL 
为 /Home/Index/Apple。 第 二 种 情况 是 ， 请 求 中 包含 
可 以 解析 的 值 但 磁 巧 是 0， 如 URL 
为 /Home/Index/0。 





大 多 数 应 用 程序 需要 区 分 这 些 状 况 ， 最 简单 的 
方式 是 使 用 可 空 类 型 作为 操作 方法 的 参数 ， 如 代码 
清单 26-10 所 示 。 





代码 清单 26-10 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 使 用 可 空 类 型 


using Microsoft.AspNetCore.Mvc; 
using MvcModels.Models; 


namespace MvcModels.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 


} 


public IActionResult Index(int? id) { 
Person person; 
if (id.HasValue && (person = repository[id. 
Value]) != null) { 
return View(person) ; 
} else { 
return NotFound() ; 





默认 可 空 类 型 的 值 是 null， 这 人 允许 区 分 请 求 中 
不 包括 可 以 解析 为 整数 值 的 情况 和 值 碰巧 是 0 的 情 
况 。 如 有 果 可 空 参数 没有 值 或 者 值 没 有 关联 模型 中 的 
对 象 ， 那 么 示例 中 Index 方 法 的 实现 将 使 用 
NotFound 方 法 来 返回 404 错 误 。 这 是 一 种 比 简 单 地 
期 望 模型 中 的 第 一 个 对 象 十 分 适当 的 更 稳健 的 方 








却 ， 也 是 之 前 采用 的 方式 。 


26.2.3 She RAR 





当 操 作 方 法 的 参数 是 复杂 类 型 的 时 候 《〈 换 句 话 
说 ， 任 何不 能 从 单个 字符 串 值 解析 到 的 类 型 ) ， 模 
型 绑 定 过 程 将 使 用 反射 来 获取 目标 类 型 的 公共 属性 
故 合 ， 然 后 依次 对 每 个 属性 执行 绑 定 过 程 。 为 了 演 
示 这 是 如 何 工 作 的 ， 在 Home 控 制 器 中 添加 两 个 操 
作 方 法 ， 如 代码 清单 26-11 所 示 。 


代码 清单 26-11 在 Controllers 文 件 夹 下 的 HomeController.cs 中 
添加 两 个 操作 方法 





using Microsoft.AspNetCore.Mvc; 
using MvcModels.Models; 


namespace MvcModels.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 


} 


public IActionResult Index(int? id) { 
Person person; 
if (id.HasValue && (person = repository[id. 
Value]) != null) { 
return View(person) ; 
} else { 
return NotFound(); 
} 
} 


public ViewResult Create() => View(new Person() 


); 


[HttpPost] 
public ViewResult Create(Person model) => View( 
"Index", model); 


} 





没有 参数 的 Create 方 法 版 本 会 创建 一 个 新 的 
Person 对 象 并 传递 给 View 方 法 ，View 方 法 将 影响 选 
择 关 联 a 到 操作 方法 的 默认 视图 。 在 Views/Home 文 件 
夹 中 创建 名 为 Create.cshtml 的 视图 文件 ， 并 添加 代 
码 清单 26-12 所 示 的 标记 。 





代码 清单 26-12 ”Views/Home 文 件 夹 下 的 Create.cshtml 文 件 的 内 


IP 


谷 


@model Person 


@{ 


ViewBag.Title = "Create Person"; 
Layout = "_Layout"; 


} 


<form asp-action="Create" method="post"> 
<div class="form-group"> 
<label asp-for="PersonId"></label> 
<input asp-for="PersonId" class="form-control" 


</div> 
<div class="form-group"> 
<label asp-for="FirstName"></label> 
<input asp-for="FirstName" class="form-control" 


</div> 
<div class="form-group"> 
<label asp-for="LastName"></label> 
<input asp-for="LastName" class="form-control" 


</div> 
<div class="form-group"> 
<label asp-for="Role"></label> 
<select asp-for="Role" class="form-control" 
asp-items="@new SelectList(Enum.GetName 
S(typeof(Role)))"></select> 
</div> 
<button type="submit" class="btn btn-primary">Submi 
t</button> 
</form> 





Createt AL — 5 BE IBA 23 Homes fill 45 


中 使 用 HttpPost 特 性 修饰 的 Create 方 法 的 表单 元 素 ， 
可 通过 它 为 Pearson 对 象 的 某 些 属性 提供 值 。 


操作 方法 接收 表单 数据 ， 然 后 使 用 /Views/ 
Home/Index.cshtml 文 件 显 示 它 们 。 局 动 应 用 ， 导 航 
到 /Home/Create， 盾 写 表 单 ， 然 后 单 击 Submit 投 钮 
来 看 看 它们 是 如 何 工 作 的 ， 如 图 26-4 所 示 。 





LastName 
First Name: Peter 


James 


Guest 








图 26-4 填写 表单 并 单 击 Submit 按 钮 


在 把 表单 数据 发 送 给 服务 器 后 ， 模 型 绑 定 系统 
发 现 操 作 方 法 需要 一 个 Person 对 象 。 分 析 Person 类 
及 其 公共 属性 。 对 于 每 个 简单 类 型 ， 模 型 绑 定 侣 试 








图 碍 找 请 求 值 ， 就 像 前 一 个 示例 那样 。 


对 于 这 个 示例 ， 模 型 绑 定 颖 发 现 了 PersonId 属 
性 ， 并 寻找 PersonId 值 ， 由 于 表单 中 包含 合适 的 值 
一 一 在 input 元 系 的 设置 中 使 用 了 asp-for 属 性 的 标签 
助手 ， 因 此 这 个 值 将 被 使 用 。 





如 果 属 性 为 男 一 复杂 类 型 ， 处 理 过 程 将 在 新 的 
类 型 上 重复 进行 。 获 取 公共 属性 集合 ， 然 后 模型 绑 
定 颖 试图 寻找 所 有 属性 的 值 。 不 同 的 是 ， 属 性 名 称 
是 艇 套 的 。 例 如 ，Person 类 的 HomeAddress 属 性 为 
Address 类 型 ， 如 下 所 示 : 








using System; 


namespace MvcModels.Models { 


public class Person { 
public int PersonId { get; set; } 
public string FirstName { get; set; } 
public string LastName { get; set; } 
public DateTime BirthDate { get; set; } 
public Address HomeAddress { get; set; } 
public bool IsApproved { get; set; } 


public Role Role { get; set; } 
} 


public class Address { 
public string Line1 { get; set; } 
public string Line2 { get; set; } 
public string City { get; set; } 
public string PostalCode { get; set; } 
public string Country { get; set; } 


} 

public enum Role { 
Admin, 
User, 
Guest 





1 F RLinel BERMAN, PEASE AEA 
HomeAddress.Line1 奋 找 值 一 一 由 模型 对 象 属性 的 
名 称 合并 骸 套 的 模型 类 型 属性 名 组 成 。 








1. 创建 易于 绑 定 的 HTML 





前 级 意味 看 视图 必须 包含 模型 绑 定 副 俘 找 的 信 
娠 。 使 用 标签 助手 可 以 很 容易 实现 ， 标 签 助 手 能 目 
动 将 需要 的 前 级 添加 到 它们 想 要 转换 的 元 素 上 。 代 


人 码 清单 26-13 扩 展 了 表单 以 便 可 以 获取 地 址 数据 。 


代码 清单 26-13 ”在 Views/Home 文 件 夹 下 更 新 Create.cshtml 文 件 
中 的 表单 





@model Person 


@{ 


ViewBag.Title = "Create Person"; 


Layout = "_Layout"; 


} 


<form asp-action="Create" method="post"> 
<div class="form-group"> 
<label asp-for="PersonId"></label> 
<input asp-for="PersonId" class="form-control" 
/> 
</div> 
<div class="form-group"> 
<label asp-for="FirstName"></label> 
<input asp-for="FirstName" class="form-control" 
/> 
</div> 
<div class="form-group"> 
<label asp-for="LastName"></label> 
<input asp-for="LastName" class="form-control" 
/> 
</div> 
<div class="form-group"> 
<label asp-for="Role"></label> 
<select asp-for="Role" class="form-control" 
asp-items="@new SelectList(Enum.GetName 
s(typeof(Role)))"></select> 


</div> 
<div class="form-group"> 
<label asp-for="HomeAddress.City"></label> 
<input asp-for="HomeAddress.City" class="form-c 
ontrol" /> 
</div> 
<div class="form-group"> 
<label asp-for="HomeAddress.Country"></label> 
<input asp-for="HomeAddress.Country" class="for 
m-control" /> 
</div> 
<button type="submit" class="btn btn-primary">Submi 
t</button> 
</form> 





1 Ane BF ie REE Jee PE AA EA 
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HomeAddress.Country。 如 果 运 行 应 用 程序 ， 访 
问 / 昌 ome/Create， 然 后 检查 发 送 给 浏览 器 的 
HTML， 你 将 看 到 对 于 一 些 属性 使 用 了 不 一 样 的 约 


ry 


JÆ: 

















<div class="form-group"> 
<label for="HomeAddress_ City">City</label> 
<input class="form-control" type="text" id="HomeAdd 
ress City" 
name="HomeAddress.City" value="" /> 
</div> 


<div class="form-group"> 
<label for="HomeAddress_ Country" >Country</label> 
<input class="form-control" type="text" id="HomeAdd 
ress Country" 
name="HomeAddress.Country" value="" /> 


</div> 





input 元 系 的 name 属 性 避 循 C# 风 格 ， 但 古 label 
元 又 的 for 属 性 和 input 元 素 的 id 属 性 使 用 下 面 线 分 隐 
属性 名 称 。 如 果 和 希望 不 使 用 标签 助手 来 定义 HITML 
元 素 ， 那 么 需要 确保 使 用 了 同样 的 命名 模式 。 

















作为 这 一 特性 的 结 末 ， 不 需要 采用 任何 特殊 的 
行动 残 可 以 确保 模型 绑 定 右 会 为 HomeAddress 属 性 
创建 Address 对 象 。 在 数据 可 以 通过 表单 提交 之 后 ， 
可 以 通过 编辑 Index.cshtml 视 图 文件 来 显示 
HomeAddress 属 性 ， 如 代码 清单 26-14 所 示 。 








代码 清单 26-14 在 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 中 
显示 HomeAddress 属 性 


@model Person 
@{ Layout = " Layout"; } 


<div class="bg-primary m-1 p-1 text-white"><h2>Person</ 
h2></div> 


<table class="table table-sm table-bordered table-strip 
ed"> 
<tr><th>PersonId:</th><td>@Model.PersonId</td></tr> 
<tr><th>First Name:</th><td>@Model .FirstName</td></ 
tr> 
<tr><th>Last Name: </th><td>@Model.LastName</td></tr 


<tr><th>Role:</th><td>@Model .Role</td></tr> 

<tr><thoCity:</th><td>@Model .HomeAddress?.City</td> 
</tr> 

<tr><th>Country:</th><td>@Model .HomeAddress?.Countr 
y</td></tr> 
</table> 








如 有 果 启 动 应 用 并 导航 到 URL 地 
址 /Home/Create， 就 可 以 为 City 和 Country 文 本 框 输 
入 值 ， 通 过 提交 表单 可 以 检查 它们 是 否 已 被 绑 定 到 
模型 对 象 ， 如 图 26-5 所 示 。 





Country 








图 26-5 ” 绑 定 复杂 对 象 中 的 属性 
2， 指 定 目 定 义 前 绥 


在 有 的 场合 中 ， 生 成 的 HIML 已 关联 一 种 类 
型 ， 但 是 希望 将 HIML 绑 定 到 另外 一 种 类 型 。 这 总 
味 着 视图 包含 的 前 绥 不 对 应 模型 绑 定 期 望 的 结构 ， 
所 以 数据 不 会 被 正确 处 理 。 为 了 说 明 这 个 问题 ， 添 
加 一 个 名 为 AddressSummary.cs 的 类 文件 到 Models 文 
件 夹 中 ， 用 它 定 义 代 码 清单 26-15 所 示 的 类 。 





代码 清单 26-15 ”Models 文 件 夹 下 的 AddressSummary.cs 文 件 的 


namespace MvcModels.Models { 


public class AddressSummary { 


public string City { get; set; } 
public string Country { get; set; } 





在 Home 控 制 器 中 添加 一 个 新 的 使 用 
AddressSummary 关 的 操作 方法 ， 如 代码 清单 26-16 
所 示 。 





代码 清单 26-16 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 添加 一 个 操作 方法 





using Microsoft.AspNetCore.Mvc; 
using MvcModels.Models; 


namespace MvcModels.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 


} 


public IActionResult Index(int? id) { 
Person person; 
if (id.HasValue && (person = repository[id. 
Value]) != null) { 
return View(person) ; 
} else { 
return NotFound(); 
} 
} 


public ViewResult Create() => View(new Person() 


[HttpPost | 
public ViewResult Create(Person model) => View( 
"Index", model); 


public ViewResult DisplaySummary(AddressSummary 
summary) => View(summary) ; 


i 


} 





新 的 操作 方法 名 为 DisplaySummary， 它 的 
AddressSummary2 204% (8 2826 View Jy 7% LE BE Bx 
默认 视图 显示 。 在 /Views/Home 文 件 夹 中 创建 
DisplaySummary.cshtml 文 件 ， 添 加 代码 清单 26-17 上 所 
示 的 标记 内 容 。 


代码 清单 26-17 Views/Home 文 件 夹 下 的 


DisplaySummary.cshtml 文 件 的 内 容 


@model AddressSummary 


@{ 
ViewBag.Title = "DisplaySummary" ; 
Layout = "Layout"; 

} 


<div class="bg-primary m-1 p-1 text-white"><h2>Address< 


/h2></div> 


<table class="table table-sm table-bordered table-strip 
ed"> 
<tr><thoCity:</th><td>@Model.City</td></tr> 
<tr><th>Country :</th><td>@Model .Country</td></tr> 
</table> 








DisplaySummary 视 图 显示 了 AddressSummary 类 
中 定义 的 两 个 属性 的 值 。 为 了 演示 使 用 前 级 绑 定 到 
不 同 的 模型 类 型 时 引发 的 问题 ， 修 改 Create.cshtml 
视图 文件 中 的 表单 元 系 以 有 友 送 数据 给 
DisplaySummary 操 作 ， 如 代码 清单 26-18 所 示 。 





代码 清单 26-18 ”在 Views/Home 文 件 夹 下 的 Create.cshtml 文 件 中 
修改 表单 的 操作 目标 


@model Person 


@{ 
ViewBag.Title = "Create Person"; 
Layout = " Layout"; 

} 


<form asp-action="DisplaySummary" method="post" > 


<!-- HTML elements omitted for brevity --> 


</form> 








启动 应 用 并 导航 到 URL 地 址 /Home/Create， 看 
看 发 生 了 什么 。 提 交 表 单 后 ， 你 为 City 和 Country 文 
本 框 输入 的 值 不 会 显示 在 DisplaySummary 视 图 生成 
的 HTML 中 。 





问题 在 于 form 元 系 的 name 属 性 有 HomeAddress 
前 级 ， 在 试图 绑 定 到 AddressSummary 类 型 时 ， 它 不 


是 模型 绑 定 器 想 要 寻找 的 内 容 。 


为 解决 这 个 问题 ，Bind 特 性 可 以 被 应 用 于 操作 
方法 的 参数 ， 从 而 在 模型 绑 定 中 指定 前 级 ， 如 代码 
清单 26-19 所 示 。 


代码 清单 26-19 ”在 Controllers 文 件 夹 下 的 HomeController.cs 中 
变更 模型 绑 定 前 绥 





using Microsoft.AspNetCore.Mvc; 
using MvcModels.Models; 


namespace MvcModels.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 


} 


public IActionResult Index(int? id) { 
Person person; 
if (id.HasValue && (person = repository[id. 
Value]) != null) { 
return View(person); 
} else { 
return NotFound(); 
} 
} 


public ViewResult Create() => View(new Person() 
); 

[HttpPost] 

public ViewResult Create(Person model) => View( 
"Index", model); 


public ViewResult DisplaySummary( 
[Bind(Prefix = nameof(Person.HomeAddress) ) ] 
AddressSummary summary) 


=> View(summary) ; 





TH AST, (AE WORSE. EAT 
AddressSummary 对 象 的 属性 时 ， 模 型 绑 定 器 将 在 请 
求 中 寻找 HomeAddress.City 和 HomeAddress.Country 
的 值 。 如 末 运 行 应 用 并 重新 提交 表单 ， 你 将 看 City 
和 Country 文 本 框 中 的 值 现在 正确 显示 ， 如 图 26-6 所 
示 。 对 于 简单 问题 来 说 ， 这 看 起 来 有 些 复杂 ， 但 是 
绑 定 到 不 同类 型 的 对 象 很 常见， 并 且 是 值得 学 习 的 
技术 。 





DisplaySummary 
< C |© localhost5 133 ySummary Rj : 


Address 
Paris 
France 


City: 





图 26-6 ” 绑 定 到 不 同类 型 对 象 的 属性 
3. 选择 性 绑 定 属性 


想象 一 下 ，AddressSummary 类 的 Country 属 性 
特别 敏感 ， 用 户 不 应 该 能 够 为 它 指 定 值 。 你 可 以 做 
的 第 一 件 事 ， 束 是 通过 确保 不 会 在 应 用 的 任何 涉及 
这 个 属性 的 视图 的 HTML 元 到 中 包含 它 ， 以 防止 用 
户 簿 看 或 编辑 这 个 属性 。 











然而 ， 亚 意 用 户 可 以 简单 地 在 提交 表单 数据 的 
时 候 ， 编 辑 肥 送 给 服务 器 的 表单 数据 并 挑选 合适 的 
Country 属 性 值 。 这 里 需要 告诉 模型 绑 定 右 不 要 从 请 
求 中 为 Country 属 性 绑 定 值 。 这 可 以 通过 配置 操作 方 
法 参数 的 Bind 特 性 来 实现 ， 如 代码 清单 26-20 所 示 。 


代码 清单 26-20 在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 指定 属性 


using Microsoft.AspNetCore.Mvc; 


using MvcModels.Models; 
namespace MvcModels.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 


public IActionResult Index(int? id) { 
Person person; 
if (id.HasValue && (person = repository[id. 
Value]) != null) { 
return View(person) ; 
} else { 
return NotFound(); 
} 
} 


public ViewResult Create() => View(new Person() 


); 


[HttpPost ] 
public ViewResult Create(Person model) => View( 
"Index", model); 


public ViewResult DisplaySummary( 
[ Bind(nameof(AddressSummary.City), Prefix = 
nameof (Person.HomeAddress) ) ] 
AddressSummary summary) => View(summary 





Bind 特 性 的 第 一 个 参数 是 以 逗号 分 隔 的 应 当 被 
模型 绑 定 过 程 包含 的 属性 名 称 列表 。 在 这 个 列表 
下 ， 指 定 了 City 属 性 应 当 包含 在 过 程 中 ， 由 于 


Country 没 有 列 入 ， 这 意味 着 Country 属 性 将 被 排 
除 。 








如 果 运 行 应 用 ， 访 问 /Home/Create， 然 后 填充 
表单 并 提交 ， 你 将 看 到 Country 属性 的 值 没有 显示 
出 来 ， 即 使 已 作为 浏览 器 HTTP POST 请 求 的 一 部 分 
被 发 送 ， 如 图 26-7 所 示 。 





} DisplaySummary 
€ G | © localhost 


F 


City: 
Country: 


图 26-7 ”在 模型 绑 定 过 程 中 排除 属性 


当 Bind 特 性 被 应 用 于 操作 方法 的 参数 时 ， 它 仅 
仅 影响 为 这 个 类 的 实例 绑 定 的 操作 方法 ， 其 他 所 有 





的 操作 方法 将 继续 试图 绑 定 参数 类型 定义 的 所 有 属 
性 。 为 了 使 Bind 特 性 发 挥 更 广泛 的 影响 ， 可 以 将 
Bind 特 性 应 用 于 模型 类 本 里， 如 代码 清单 26-21 所 
未。 
代码 清单 26-21 在 Models 文 件 夹 下 的 AddressSummary.cs 文 件 
中 应 用 Bind 特 性 
using Microsoft.AspNetCore.Mvc; 


namespace MvcModels.Models { 


[Bind(nameof (City) )] 


public class AddressSummary { 
public string City { get; set; } 


public string Country { get; set; } 
} 





也 可 以 使 用 BindNever 特 性 来 显 式 地 排除 属 
性 ， 如 代码 清单 26-22 所 示 ， 虽 然 这 意味 着 新 添加 
到 模型 类 的 属性 将 被 包含 在 模型 绑 定 过 程 中 ， 除 非 
为 它们 应 用 这 个 特性 。 





代码 清单 26-22 ”在 Models 文 件 夹 下 的 AddressSummary.cs 文 件 
中 应 用 BindNever 特 性 


using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.ModelBinding; 


namespace MvcModels.Models { 


public class AddressSummary { 


public string City { get; set; } 


[BindNever ] 
public string Country { get; set; } 





he 示 





BindRequired 特 性 用 于 告诉 模型 绑 定 过 程 ， 请 
求 中 必须 包含 属性 的 值 。 如 果 请 求 中 没有 包含 必要 


的 值 ， 将 会 导致 模型 验证 错误 ， 详 见 第 27 章 。 


26.2.4 She MAME 








模型 绑 定 有 一 些 不 错 的 特性 用 于 绑 定 请 求 数据 
到 数组 和 集合 ， 下 面 进行 说 明 。 


1. 绑 定 到 数组 





模型 绑 定 默认 的 优雅 特性 在 于 文 持 数组 类 型 的 
操作 方法 参数 。 为 了 说 明 这 一 点 ， 在 Home 控 制 絮 
中 这 加 名 为 Names 的 新 方法 ， 如 代码 清单 26-23 所 


人 小。 


代码 清单 26-23 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 添加 Names 方 法 





using Microsoft.AspNetCore.Mvc; 
using MvcModels.Models; 


namespace MvcModels.Controllers { 


public class HomeController : Controller { 


private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 


} 


public IActionResult Index(int? id) { 
Person person; 
if (id.HasValue && (person = repository[id. 
Value]) != null) { 
return View(person); 
} else { 
return NotFound(); 
} 
} 


public ViewResult Create() => View(new Person() 
); 

[HttpPost] 

public ViewResult Create(Person model) => View( 
"Index", model); 


public ViewResult DisplaySummary ( 
[ Bind(nameof(AddressSummary.City), Prefix = 
nameof(Person.HomeAddress) ) | 
AddressSummary summary) => View(summary 


J 


public ViewResult Names(string[] names) => View 
(names ?? new string[6]); 


} 


} 





Names 方 法 有 一 个 名 为 names 的 字符 串 数 组 参 


数 。 模 型 绑 定 器 将 得 询 名 为 names 且 包含 这 些 值 的 
任何 数据 项 来 创建 数组 ， 为 了 给 这 个 操作 方法 提供 
视图 ， 在 Views/Home 文 件 夹 中 创建 名 为 
Names.cshtml 的 Razor 文 件 ， 并 添加 代码 清单 26-24 
所 示 的 标记 内 容 。 











代码 清单 26-24 Views/Home 文 件 夹 下 的 Names.cshtml 文 件 的 
内 容 





@model string[] 
@{ 


ViewBag.Title = "Names"; 
Layout = " Layout"; 
} 


@if (Model.Length == @) { 
<form asp-action="Names" method="post"> 
@for (int i = ð; i < 3; i++) { 
<div class="form-group" > 
<label>Name @(i + 1):</label> 
<input id="names" name="names" class="f 
orm-control" /> 
</div> 


<button type="submit" class="btn btn-primary">s 
ubmit</button> 
</form> 
} else { 


<table class="table table-sm table-bordered table-s 
triped"> 
@foreach (string name in Model) { 
<tr><th>Name: </th><td>@name</td></tr> 


} 
</table> 


<a asp-action="Names" class="btn btn-primary">Back< 
/a> 


} 








Names 视 图 基于 视图 模型 中 包含 的 数据 项 的 个 
数 展示 不 同 的 内 容 。 如 末 没 有 数据 项 ， 访 视图 将 显 
示 包 含 3 个 完全 相同 的 input 元 素 的 表单 ， 如 下 所 


ed 


ZN: 








<form method="post" action="/Home/Names"> 
<div class="form-group"> 
<label>Name 1:</label> 
<input id="names" name="names" class="form-cont 
rol" /> 
</div> 
<div class="form-group"> 
<label>Name 2:</label> 
<input id="names" name="names" class="form-cont 
rol" /> 
</div> 
<div class="form-group"> 
<label>Name 3:</label> 
<input id="names" name="names" class="form-cont 


rol" /> 

</div> 

<button type="submit" class="btn btn-primary">Submi 
t</button> 
</form> 





当 表 单 被 提交 之 后 ， 模 型 绑 定 过 程 查看 目标 操 
作 方 法 并 得 到 一 个 数组 ， 查 询 与 操作 方法 参数 具有 
相同 名 称 的 数据 项 。 对 于 这 个 示例 来 说 ， 这 意味 着 
所 有 name 属 性 为 names 的 input 元 素 的 值 将 被 收集 在 
一 起 以 创建 数组 ， 并 作为 参数 调用 操作 方法 。 为 了 
BAR, AIMH, Sit 2/Home/Names, HE 
表单 并 提交 ， 你 将 看 到 输入 的 所 有 值 都 显示 出 来 ， 
如 图 26-8 所 示 。 








Name: 
Name: 


Name: = Peter 


Name 3: 





图 26-8” 绑 定 到 数组 





2. REIRE 


模型 绑 定 堪 不 仅 可 以 绑 定 数组 ， 还 可 以 绑 定 集 
合 。 代 码 清 单 26-25 将 Names 方 法 的 参数 类 型 修改 为 


强 类 型 集合 。 


代码 清单 26-25 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 使 用 强 类 型 集合 





using Microsoft.AspNetCore.Mvc; 
using MvcModels.Models; 
using System.Collections.Generic; 


namespace MvcModels.Controllers { 
public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 
} 


// ...other action methods omitted for brevity. 


public ViewResult Names(IList<string> names) => 
View(names ?? new List<string>()); 


这 里 使 用 了 IList< 工 > 接 口 。 不 需要 指定 具体 的 
实现 类 ， 虽 然 根 据 个 人 意愿 也 可 以 这 么 做 。 代 码 清 
单 26-26 修 改 了 Names.cshtml 视 图 文件 以 使 用 新 的 模 


型 类 型 。 





代码 清单 26-26 ”在 Views/Home 文 件 夹 下 的 Names.cshtml 文 件 
中 使 用 集合 作为 模型 类 型 








@model IList<string> 
@{ 


ViewBag.Title = "Names"; 
Layout = " Layout"; 
} 


@if (Model.Count == 6) { 
<form asp-action="Names" method="post"> 
@for (int i = ð; i < 3; i++) { 
<div class="form-group" > 
<label>Name @(i + 1):</label> 
<input id="names" name="names" class="f 
orm-control" /> 
</div> 
} 
<button type="submit" class="btn btn-primary">S 
ubmit</button> 
</form> 


} else { 
<table class="table table-sm table-bordered table-s 
triped"> 
@foreach (string name in Model) { 
<tr><th>Name: </th><td>@name</td></tr> 
} 


</table> 


<a asp-action="Names" class="btn btn-primary">Back< 
/a> 


} 





Names 方 法 的 功能 没有 变化 ， 但 是 现在 可 以 使 
用 集合 而 不 是 数组 进行 工作 。 


3. 绑 定 到 复杂 类 型 的 集合 


单个 数据 值 可 以 绑 定 到 复业 类 型 的 集合 ， 这 侈 
许 在 单个 请 求 中 收集 多 个 对 象 〈 比 如 示例 中 的 
AddressSummary 模 型 类 ) 。 代 人 码 清 单 26-27 在 Home 
控制 器 中 添加 了 名 为 Address 的 操作 方法 ， 参 数 是 一 
个 AddressSummary 对 象 列表 。 





代码 清单 26-27 在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 定义 操作 方法 





using Microsoft.AspNetCore.Mvc; 
using MvcModels.Models; 
using System.Collections.Generic; 


namespace MvcModels.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 


} 


public IActionResult Index(int? id) { 
Person person; 
if (id.HasValue && (person = repository[id. 
Value]) != null) { 
return View(person); 
} else { 
return NotFound(); 
} 
} 


public ViewResult Create() => View(new Person() 


); 


[HttpPost ] 
public ViewResult Create(Person model) => View( 
"Index", model); 


public ViewResult DisplaySummary( 
[ Bind(nameof(AddressSummary.City), Prefix = 
nameof(Person.HomeAddress) ) | 
AddressSummary summary) => View(summary 


J; 


public ViewResult Names(IList<string> names) => 
View(names ?? new List<string>()); 


public ViewResult Address(IList<AddressSummary> 
addresses) => 
View(addresses ?? new List<AddressSummary>( 








为 了 给 这 个 新 的 操作 方法 提供 视图 ， 在 
Views 人 /Home 文 件 夹 中 添加 名 为 Address.cshtml 的 文 
件 ， 并 添加 代码 清单 26-28 所 示 的 标记 内 容 。 


代码 清单 26-28 Views/Home 文 件 夹 下 的 Address.cshtml 文 件 的 
内 容 





@model IList<AddressSummary> 
@{ 


ViewBag.Title = "Address"; 


Layout = " Layout"; 
} 


@if (Model.Count() == @) { 
<form asp-action="Address" method="post"> 
@for (int i = ð; i < 3; i++) { 
<fieldset class="form-group"> 
<legend>Address @(i + 1)</legend> 
<div class="form-group"> 


<label>City:</label> 
<input name="[@i].City" class="form 
-control" /> 
</div> 
<div class="form-group"> 
<label>Country:</label> 
<input name="[@i].Country" class="f 
orm-control" /> 
</div> 
</fieldset> 
} 
<button type="submit" class="btn btn-primary">S 
ubmit</button> 
</form> 
} else { 
<table class="table table-sm table-bordered table-s 
triped"> 
<tr><th>City</th><th>Country</th></tr> 
@foreach (var address in Model) { 
<tr><td>@address.City</td><td>@address.Coun 
try</td></tr> 
} 
</table> 
<a asp-action="Address" class="btn btn-primary">Bac 
k</a> 
} 





如 果 模 型 集合 中 没有 条 上 日 ，Address 视 图 将 后 
成 一 个 form 元 素 。 这 个 form 元 和 素 包 含 name 属 性 带 有 
数组 索引 前 缀 的 input 元 素 对 ， 如 下 所 示 : 





<form method="post" action="/Home/Address"> 
<fieldset class="form-group"> 
<legend>Address 1</legend> 
<div class="form-group"> 
<label>City:</label> 
<input name="[0].City" class="form-control" 


/> 

</div> 

<div class="form-group"> 
<label>Country:</label> 
<input name="[0].Country" class="form-contr 

ol" /> 
</div> 
</fieldset> 


<fieldset class="form-group"> 
<legend>Address 2</legend> 
<div class="form-group"> 
<label>City:</label> 
<input name="[1].City" class="form-control" 


/> 

</div> 

<div class="form-group"> 
<label>Country:</label> 
<input name="[1].Country" class="form-contr 

ol" /> 
</div> 
</fieldset> 


<fieldset class="form-group"> 
<legend>Address 3</legend> 
<div class="form-group"> 
<label>City:</label> 
<input name="[2].City" class="form-control" 
/> 
</div> 


<div class="form-group"> 
<label>Country:</label> 
<input name="[2].Country" class="form-contr 
ol" /> 


</div> 
</fieldset> 
<button type="submit" class="btn btn-primary">Submi 
t</button> 
</form> 











表单 被 提交 后 ， 模 型 绑 定 器 意识 到 需要 创建 
AddressSummary 对 象 集合 ， 使 用 name 属 性 的 数组 
索引 前 级 来 获取 对 象 的 属性 值 。 属 性 前 级 [0] 用 于 第 
一 个 AddressSummary 对 象 ， 属 性 前 级 [1] 用 于 第 二 
个 AddressSummary 对 象 ， 以 此 类 推 。 





Address 视 图 为 三 个 索引 的 对 象 定义 了 input 元 
素 ， 在 模型 集合 含有 条 目的 时 候 显示 它们 。 在 加 以 
说 明之 前 ， 需 要 从 AddressSummary 模 型 类 中 删除 
BindNever 特 性 ， 如 代码 清单 26-29 所 示 ; AN, We 
型 绑 定 器 将 会 忽略 Country 属 性 。 














代码 清单 26-29 在 Models 文 件 夹 下 的 AddressSummary.cs 文 件 
中 删除 BindNever 特 性 


using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore.Mvc.ModelBinding; 


namespace MvcModels.Models { 


public class AddressSummary { 


public string City { get; set; } 


//[BindNever ] 
public string Country { get; set; } 
} 
} 








通过 启动 应 用 并 导航 到 URL 地 
址 /Home/Address， 单 击 Submit 按 钮 发 送 表 单 到 服务 
萎 ， 就 可 以 看 到 目 定 义 对 象 集合 的 绑 定 过 程 是 如 何 
LEN. 








模型 绑 定 过 程 将 寻找 并 处 理 索 引 的 数据 值 ， 然 
后 使 用 它们 创建 AddressSummary 对 象 集合 并 提供 给 
操作 方法 ， 最 后 使 用 View 便 捷 方 法 将 它们 传递 回 视 


图 以 便 可 以 显示 出 来 ， 如 图 26-9 所 示 。 


= O 
€ C |© localhost Home/A wine 
Address 1 
City: 
ress 
London 
€ C | O localhost 
City 
London 
Paris France 
mr _ _ 
Berlin 
rE 








图 26-9” 绑 定 到 自 定义 对 象 的 集合 
26.3 ”指定 模型 绑 定 源 


模型 绑 定 过 程 默 认 从 3 个 位 置 〈 表 单数 据 、 路 
由 变量 以 及 得 询 串 ) 寻找 数据 。 





默认 的 搜索 顺序 并 不 总 是 有 用 ， 可 能 是 因为 希 
鹿 数 据 来 目 请 求 的 东 个 特定 部 分 ， 也 可 能 因为 希望 
使 用 默认 不 搜索 的 数据 源 。 模 型 绑 定 源 包 含 一 系列 
HRE i BRU GE ART ARETE, AE 26-3 PAN o 


表 26-3 ”模型 绑 定 源 的 特性 





特性 


性 ] 术 
指定 表单 数据 作为 数据 绑 定 源 。 参 数 名 称 默 认 用 于 定位 表单 值 ， 但 可 以 使 用 
FromForm 
Name 属 性 指定 不 同 的 名 称 
指定 路 由 变量 作为 数据 绑 定 源 。 参 数 名 称 默 认 用 于 定位 路 由 变量 值 ， 但 可 以 
FromRoute 
使 用 Name 属 性 指定 不 同 的 名 称 


































































































指定 查询 串 作 为 数据 绑 定 源 。 参 数 名 称 默 认 用 于 定位 查询 串 值 ， 但 可 以 使 用 
FromQuery 
Name 属 性 指定 不 同 的 名 称 


A E 指定 请 求 头 作为 数据 绑 定 源 。 参 数 名 称 默 认 用 于 定位 请 求 头 的 名 称 ， 但 可 以 
rommeader 
使 用 Name 属 性 指定 不 同 的 名 称 


| 指定 请 求 体 作为 数据 绪 定 源 。 如 果 需 要 从 不 是 表单 编码 的 请 求 中 接收 数据 
romDo 
” | (例如 在 API 控 制 器 中 ， 就 需要 使 用 这 个 特性 ) 



























































26.3.1 选择 标准 绑 定 源 


FromForm、FromRoute 以 及 FromQuery 特 性 允 
许 指定 模型 绑 定 数据 将 从 标准 位 置 获取 ， 但 不 使 用 
正 弟 的 搜索 有 顺序。 本 草 开 头 使 用 的 是 下 面 这 个 








URL: 


/Home/Index/3?id=1 


这 个 URL 包 含 可 以 用 于 Home 控 制 右 中 Index 方 
法 的 id 参 数 的 两 个 可 能 值 。 路 由 系统 将 URL 的 最 后 
部 分 赋予 名 为 id 的 变量 ，id 变 量 定义 在 Startup 类 中 
的 URL 模 板 中 ， 查 询 串 也 包含 id 值 。 使 用 默认 的 搜 
索 模 式 意味 着 模型 绑 定 数据 将 从 路 由 变量 中 获取 ， 
租 询 串 将 被 忽略 。 

















为 了 改变 这 个 行为 ， 代 码 清单 26-30 将 
FromQuery 特 性 应 用 于 Index 方 法 。 为 了 保持 示例 简 
单 ， 这 里 还 将 前 面 定 义 的 其 他 操作 方法 删除 了 。 





代码 清单 26-30 ”在 Controllers 文 件 夹 下 的 HomeController.cs 中 
使 用 查询 串 





using Microsoft.AspNetCore.Mvc; 
using MvcModels.Models; 


namespace MvcModels.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 
} 


public IActionResult Index([FromQuery] int? id) 


Person person; 


if (id.HasValue && (person = repository[id. 
Value]) != null) { 
return View(person) ; 
} else { 
return NotFound(); 





以 上 代码 为 id 参数 应 用 了 FromQuery 特 性 ， 这 
意味 着 在 模型 绑 定 过 程 中 ， 碍 询 id 值 的 时 候 仅 仅 碍 
询 串 被 使 用 。 


o 


fe ” 示 

在 指定 模型 绑 定 源 《 比 如 查询 串 ) 时 ， 仍 然 可 
以 绑 定 复杂 类 型 。 对 于 参数 类 型 的 每 个 简单 属性 ， 
模型 绑 定 过 程 将 使 用 同样 的 名 字 搜 索 查 询 串 的 键 。 





26.3.2 ”使 用 请 求 头 作为 绑 定 源 


FromHeader 特 性 允许 将 HTTP 请 求 头 作 为 数据 
绑 定 源 。 代 码 清单 26-31 在 Home 控 制 器 中 添加 了 一 
个 简单 的 操作 方法 ， 用 于 从 标准 的 HTTP 请 求 头 中 
接收 参数 。 


代码 清单 26-31 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 通过 请 求 涉 进 行 绑 定 








using Microsoft.AspNetCore.Mvc; 
using MvcModels.Models; 


namespace MvcModels.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 
} 


public IActionResult Index([FromQuery] int? id) 


Person person; 
if (id.HasValue && (person = repository[id. 
Value]) != null) { 
return View(person) ; 
} else { 
return NotFound(); 
} 
} 


public string Header([FromHeader]string accept) 
=> $"Header: {accept}"; 


} 


} 





Header 方 法 定义 了 一 个 accept 参 数 ， 当 前 请 求 
中 的 Accept 请 求 头 的 值 将 被 接收 并 作为 方法 的 络 采 
返回 。 如 果 运 行 应 用 并 访问 /Home/Header， 你 将 看 
到 类 似 于 下 面 的 结果 (虽然 基于 使 用 的 浏览 器 不 
同 ， 确 切 的 执行 结果 可 能 也 不 同 ) : 


Header: text/html, application/xhtml+xml, application/xml 





;q=0.9,image/webp, */*;q=0.8 


并 不 是 所 有 的 HITP 请 求 头 名 称 都 可 以 依靠 操 
作 方 法 的 参数 名 称 易于 选择 ， 因 为 模型 绑 定 系统 不 
能 使 用 HTTP 请 求 头 从 C# 命 名 约定 进行 转换 。 在 这 
些 情况 下 ， 必 须 使 用 Name 属 性 配置 FromHeader 特 
性 以 指定 请 求 头 的 名 称 ， 如 代码 清单 26-32 所 示 。 


代码 清单 26-32 ”在 Controllers 文 件 夹 下 的 HomeController.cs 中 
指定 请 求 头 的 名 称 











using Microsoft.AspNetCore.Mvc; 
using MvcModels.Models; 


namespace MvcModels.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 

} 

public IActionResult Index([FromQuery] int? id) 


Person person; 


if (id.HasValue && (person = repository[id. 
Value]) != null) { 
return View(person) ; 
} else { 
return NotFound(); 
} 
} 


public string Header([FromHeader(Name = "Accept 
-Language")] string accept) 
=> $"Header: {accept}"; 


} 





不 能 使 用 Accept-Language 作 为 C# 参 数 名 称 ， 
模型 绑 定 器 也 不 能 目 动 将 AcceptLanguage 转 换 为 
Accept- Language 以 便 匹 配 请 求 次。 相反， 这 里 使 
用 Name 属 性 来 配置 特性 ， 进 而 匹配 正确 的 请 求 
头 。 如 果 局 动 应 用 并 访问 /Home/Header， 你 将 看 到 
类 似 下 面 的 啊 应 ， 这 将 基于 不 同 的 区 域 设 置 而 有 所 
BPs 


Header: en-US,en;q=0.8 


从 请 求 头 绑 定 复杂 类 型 





尽管 需求 十 分 罕见 ， 但 仍然 可 以 通过 应 用 
FromHeader 特 性 到 模型 类 的 属性 来 使 用 请 求 头 中 的 
值 绑 定 复杂 类 型 。 作 为 示例 ， 在 Models 文 件 夹 中 还 
加 名 为 HeaderModelcs 的 类 文件 ， 定 义 代码 清单 26- 
33 所 示 的 类 。 





代码 清单 26-33 Models 文 件 夹 下 的 HeaderModel.cs 文 件 的 内 容 


using Microsoft.AspNetCore.Mvc; 
namespace MvcModels.Models { 
public class HeaderModel { 


[FromHeader ] 
public string Accept { get; set; } 


[FromHeader(Name = "Accept-Language”" ) ] 
public string AcceptLanguage { get; set; } 


[FromHeader(Name = "Accept-Encoding" ) ] 
public string AcceptEncoding { get; set; } 





这 个 类 定义 了 3 个 属性 ， 其 中 的 每 个 都 使 用 


FromHeader 特 性 进行 了 修饰 。 可 在 其 中 两 个 
FromHeader 特 性 中 使 用 Name 属 性 来 指定 不 能 表示 
为 C# 人 参数 名 的 请 求 头 名 称 。 代 码 清单 26-34 更 新 了 
Home 控 制 器 的 Header 方 法 以 接收 HeaderModel 对 
象 。 





代码 清单 26-34 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 使 用 Header 模 型 类 





using Microsoft.AspNetCore.Mvc; 
using MvcModels.Models; 


namespace MvcModels.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 
} 


public IActionResult Index([FromQuery] int? id) 


Person person; 
if (id.HasValue && (person = repository[id. 
Value]) != null) { 
return View(person) ; 
} else { 


return NotFound(); 
} 


public ViewResult Header(HeaderModel model) => 
View(model1) ; 


} 


} 








为 了 完成 示例 ， 在 Views/Home 文 件 夹 中 添加 
名 为 Header.cshtml 的 视图 文件 ， 并 添加 代码 清单 26- 
35 所 示 的 标记 内 容 。 


代码 清单 26-35 ”Views/Home 文 件 夹 下 的 Header.cshtml 文 件 的 


内 容 


@model HeaderModel 

@{ 
ViewBag.Title = "Headers"; 
Layout = " Layout"; 

} 


<table class="table table-sm table-bordered table-strip 


ed"> 


<tr><th>Accept: </th><td>@Model.Accept</td></tr> 

<tr><th>Accept-Encoding: </th><td>@Model .AcceptEncod 
ing</td></tr> 

<tr><th>Accept-Language: </th><td>@Model.AcceptLangu 
age</td></tr> 
</table> 





模型 绑 定 过 程 将 检 枉 复杂 类 型 的 属性 以 查找 表 
26-3 中 的 特性 。 如 果 运 行 应 用 并 访 
问 /Home/Header， 你 将 会 看 到 ， 这 人 允许 使 用 
FromHeader 特性 来 定义 从 请 求 头 绑 定 复杂 类型 的 
属性 。 产 生 的 结果 如 图 26-10 所 示 。 


text/html, application/xhtml+xml,application/xml:q=0.9,image/webp,image/apng,*/*:q=0. 


图 26-10 “从 请 求 头 中 模型 绑 定 复杂 类 型 


26.3.3 ”使 用 请 求 体 作 为 绑 定 源 





不 是 所 有 的 客户 志 数据 都 以 表单 形式 及 送 ， 比 
Qo 4 JavaScript? P vig RIKISONAL HEL APIS till 48 
IY. FromBody fF P45 xE ves RKA 4 EHEN 
模型 绑 定 源 。 代 码 清单 26-36 添 加 了 名 为 Body 的 操 
作 方 法 来 演示 有 具体 如 何 工 作 。 


代码 清单 26-36 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 添加 操作 方法 





using Microsoft.AspNetCore.Mvc; 
using MvcModels.Models; 


namespace MvcModels.Controllers { 


public class HomeController : Controller { 
private IRepository repository; 


public HomeController(IRepository repo) { 
repository = repo; 


} 


public IActionResult Index([FromQuery] int? id) 


Person person; 
if (id.HasValue && (person = repository[id. 
Value]) != null) { 
return View(person); 
} else { 
return NotFound(); 
} 
} 


public ViewResult Header(HeaderModel model) => 
View(model1) ; 


public ViewResult Body() => View(); 
[HttpPost ] 


public Person Body([FromBody]Person model) => m 
odel; 


} 


这 里 使 用 FromBody 特 性 修饰 了 Body 方 法 的 参 
数 以 接收 POST 请 求 ， 这 意味 着 请 求 体 的 内 容 将 被 
解码 并 用 于 模型 绑 定 。 参 考 第 20 章 ，MVC 拥 有 可 扩 
展 的 系统 ， 但 是 默认 仅 处 理 JSON 数 据 。 





然后 ， 编 辑 bower.json 文 件 以 添加 jQuery 包 到 应 
用 中 ， 如 代码 清单 26-37 所 示 。 


代码 清单 26-37 在 MvcModels 文 件 夹 下 的 bower.json 文 件 中 添 
加 jQuery 包 


{ 


"name": "asp.net", 
"private": true, 
"dependencies": { 


"bootstrap": "4.0.0-alpha.6", 
"jquery": "3.2.1" 
} 





} 





为 了 提供 操作 方法 需要 的 数据 ， 添 加 一 个 名 为 


Body.cshtml 的 视图 文件 到 Views/Home 文 件 来 中 ， 
添加 代码 清单 26-38 所 示 的 内 容 。 


代码 清单 26-38 ”Views/Home 文 件 夹 下 的 Body.cshtml 文 件 的 内 





容 
@{ 

ViewBag.Title = "Address"; 

Layout = "_Layout"; 
} 


@section scripts { 
<script src="/1ib/jquery/dist/jquery.min.js"></scri 
pt> 
<script type="text/javascript"> 
$(document).ready(function () { 
$("button").click(function (e) { 
$.ajax("/Home/Body", { 
method: "post", 
contentType: "“application/json", 
data: JSON.stringify({ 
firstName: "Bob", 
lastName: "Smith" 
}), 
success: function (data) { 
$("#firstName").text(data. first 
Name) ; 
$("#lastName").text(data.lastNa 
me) ; 


}); 


})3 
})3 
</script> 


} 


<table class="table table-sm table-bordered table-strip 
ed > 

<tr><th>First Name:</th><td id="firstName"></td></t 
r> 


<tr><th>Last Name:</th><td id="lastName"></td></tr> 
</table> 
<button class="btn btn-primary">Submit</button> 





为 了 催化 ，Body 视 图 包含 一 些 内 联 的 
JavaScript 代 码 ， 当 button 元 素 被单 击 时 ， 使 用 
jQuery 发 送 包 含 JSON 数 据 的 HTTP POST 请 求 
到 /Home/Body。 服 务 堪 编码 模型 绑 定 创建 的 对 象 并 
ah ISON JE AS IF Poi, ISAT ME 
问 /Home/Body， 然 后 单 击 Submit 按 钮 ， 束 可 以 看 到 
效果 ， 如 图 26-11 所 示 。 








图 26-11 将 请 求 体 用 于 模型 绑 定 


人 
提 示 


不 是 所 有 的 JavaScript 客 户 端 代码 都 需要 使 用 
FromBody 特 性 。 这 个 示例 不 得 不 避免 使 用 jQuery 便 
捷 方 法 来 发 送 Ajax POST 请 求 ， 因 为 数据 已 编码 为 
表 音 数据。 相反， 不 得 不 使 用 其 他 方法 来 允许 发 送 
JSON 数 据 。 





FromBody 特 性 只 可 以 用 于 一 个 操作 方法 参 
数 ， 如 果 这 个 特性 被 用 于 一 个 以 上 的 操作 方法 参 
数 ， 将 会 叶 致 寞 弟 。 如 末 需 要 为 一 个 请 求 体 创建 多 





个 模型 绑 定 对 象 ， 那 么 在 操作 方法 中 ， 你 将 不 得 不 
创建 一 个 简单 的 拥有 所 有 所 需 属 性 的 数据 传输 类 来 
创建 对 象 。 





26.4 ”小 结 


本 章 描述 了 模型 绑 定 过 程 ， 模 型 绑 定 用 来 从 
HTTP 请 求 中 获取 数据 ， 以 便 为 操作 方法 提供 需要 
的 参数 。 本 章 还 解释 了 如 何 绑 定 简单 闫 型 和 复杂 关 
型 ， 以 及 如 何 处 理 数 组 和 集合 ， 可 通过 应 用 特定 到 
操作 方法 参数 或 模型 关 属 性 来 控制 模型 绑 定 过 程 。 


下 一 章 将 描述 模型 验证 功能 。 





第 27 章 ”模型 验证 


上 一 章 展示 了 MVC 如 何 通过 模型 绑 定 过 程 从 
HTTP 请 求 中 创建 模型 对 象 。 本 章 介 绍 如 何 对 用 户 
提供 的 数据 进行 基本 验证 。 实 际 情况 是 ， 用 户 经 常 
输入 无 效 或 无 用 的 数据 ， 因 此 本 章 讨 论 模 型 验证 。 


恒 型 验证 古 确认 应 用 接收 到 的 数据 适合 用 来 绑 
定 到 模型 的 过 程 ， 如 果 情 况 不 是 这 样 ， 则 为 用 户 提 
供 有 助 于 解释 问题 的 有 用 信息 。 


要 完成 模型 验证 过 程 ， 第 一 步 ， 检 杏 接收 到 的 
数据 是 保持 领域 重型 完整 性 的 关键 。 拒 绝 从 领域 角 
度 看 没有 意义 的 数据 可 以 防止 应 用 程序 中 出 现 奇 怪 
或 不 希望 的 状态 。 第 二 步 ， 帮 助 用 户 纠 正 问题 也 同 
样 重 要 。 如 宋 疫 有 用 户 需 要 的 与 应 用 程序 进行 交互 
Ka Att, FP ieee Te AAS. TE TEL IAI 











公众 的 应 用 中 ， 这 意味 着 用 户 会 简单 地 放弃 使 用 这 
个 应 用 ; pe 这 意味 痢 用 户 的 工作 流 
ERMi. UENRA ARERI. BFR 
是 ，MVC 为 模型 验证 提供 广泛 的 文 持 。 表 27-1 给 出 
了 模型 验证 的 背景 。 





表 27-1 模型 验证 的 背景 











黄 型 验证 




















模型 验证 是 确保 请 求 中 提供 的 数据 可 以 在 应 用 中 胸 



































户 不 总 是 输入 有 效 的 数据 ， 在 应 用 中 使 用 无 效 数据 将 导致 无 法 预料 或 不 期 
望 的 错误 





























,。 | 控制 器 检查 验证 过 程 的 结果 ， 标 签 助 手 用 来 在 用 户 显 示 的 视图 中 包含 验证 反 
t 验证 在 模型 绑 定 过 程 中 自动 执行 ， 通 常 在 控制 器 类 中 或 者 通过 使 用 验证 


































































































寺 性 来 支持 自 定义 验证 











英 型 验证 有 
、_ | 测试 验证 代码 的 有 效 性 是 非常 重要 的 ， 确 保 它 们 能 够 阻止 应 用 接收 所 有 范 
何 缺 陷 或 局 
的 值 
限 性 ? 

















模型 验证 有 
其 他 替代 选 没有 ， 模 型 验证 它 与 ASP.NET Core MVC 紧 密集 成 


























择 吗 ? 





表 27-2 列 出 了 本 章 要 介绍 的 操作 。 


4227-2 本章 要 介绍 的 操作 





代码 清单 




















显 式 地 验证 模 
型 








月 Modelstate 记 录 验 证 错误 

















汇总 验证 错误 | 为 div 元 素 应 用 asp-validation-summary 属 性 








修改 默认 的 模 
型 绑 定 信息 





在 模型 绑 定 信息 提供 器 中 重新 定义 消息 函数 























生成 属性 级 别 
的 验证 错误 信 | 为 span 元 素 应 用 asp-validation-for 属 性 
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wy 









































生成 模型 级 别 代码 清单 27-14 
“ “| 使 用 Modelstate 记 录 没 有 关联 到 特定 属性 的 验证 错误 ， 为 | ”，“ 
的 验证 错误 信 和 代码 清和 

























































































div 元 素 的 asp-validation-summary 属 性 使 用 ModelOnly 值 
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wy 














定义 自 验 证 模 代码 清单 27-16 
为 模型 属性 应 用 数据 验证 特性 和 代码 清单 27- 


























代码 清单 27-18 
实现 IModelValidator 接 口 和 代码 清单 27- 
19 





创建 自 定 义 验 
证 特性 





























代码 清单 27-20 
使 用 jQuery 验证 和 jQuery 无 痕 验 证 包 和 代码 清单 27- 
21 








执行 客户 端 验 
证 
































代码 清单 27-22 
E | 定义 操作 方法 以 执行 验证 ， 为 模型 属性 应 用 Remote 特 性 | 和 代码 清单 27- 
23 















































27.1 人 准备 示例 项 日 





在 本 章 中 ， 使 用 ASP.NET Core Web 
Application (.NET Core) 模板 创建 名 为 
ModelVvalidation 的 Empty 项 目 。 代 码 清 单 27-1 展 示 
了 Startup 类 ， 这 里 添加 了 MVC 框 架 并 局 用 了 开发 中 
用 到 的 中 间 件 。 


代码 清单 27-1 ModelValidation 文 件 夹 下 的 Startup.cs 文 件 的 内 


IP 


谷 


using 
using 
using 
using 
using 
using 
using 
using 


System; 

System.Collections.Generic; 

System. Ling; 

System. Threading.Tasks; 
Microsoft.AspNetCore. Builder; 
Microsoft.AspNetCore.Hosting; 
Microsoft.AspNetCore.Http; 

Microsoft. Extensions .DependencyInjection; 


namespace ModelValidation { 


public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app, 


IHostingEnvironment env) { 


app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 





27.1.1 创建 模型 


首先 创建 Models 文 件 夹 ， 添 加 一 个 名 为 


Appointment.cs 的 类 文件 ， 并 用 它 定 义 代 人 码 清单 27-2 
所 示 的 类 。 


代码 清单 27-2 Models 文 件 夹 下 的 Appointment.cs 文 件 的 内 容 


using System; 
using System.ComponentModel .DataAnnotations; 


namespace ModelValidation.Models { 
public class Appointment { 


public string ClientName { get; set; } 


[UIHint( "Date" ) ] 
public DateTime Date { get; set; } 


public bool TermsAccepted { get; set; } 





Appointment 模 型 类 定义 了 3 个 属性 ， 还 使 用 了 
UIHint 特 性 来 指示 Date 属 性 应 该 展示 为 没有 时 间 部 
分 的 日 期 。 








27.1.2 ”创建 控制 器 


然后 创建 Controllers 文 件 夹 ， 添 加 一 个 名 为 
HomeController.cs 的 类 文件 ， 并 用 它 定 义 代码 清单 
27-3 所 示 的 控制 器 ， 用 以 处 理 Appointment 模 型 类 。 


代码 清单 27-3 ”Controllers 文 件 夹 下 的 HomeController.cs 文 件 的 
内 容 


using System; 
using Microsoft.AspNetCore.Mvc; 
using ModelValidation.Models; 


namespace ModelValidation.Controllers { 


public class HomeController : Controller { 
public IActionResult Index() => 


View("MakeBooking", new Appointment { Date 
DateTime.Now }); 


[HttpPost ] 
public ViewResult MakeBooking(Appointment appt) 


View("Completed", appt); 





Index 方 法 使 用 新 的 Appointment 对 象 作 为 视图 
模型 来 演 染 MakeBooking 视 图 。 在 本 章 中 ， 





MakeBooking 方 法 更 有 意义 ， 因 为 模型 验证 将 在 这 
个 操作 方法 中 处 理 。 


We 
v2 Bawa 
ve ee 


这 个 应 用 十 分 简单 ， 既 没有 定义 存储 库 ， 也 没 
有 添加 任何 代码 来 存储 模型 绑 定 过 程 中 产生 的 
Appointment 对 象 。 这 就 是 说 ， 和 需要 铭记 在 心 的 古 ， 
验证 模型 的 主要 目的 是 防止 坏 的 或 无 意义 的 数据 被 
放置 到 存储 库 中 并 导致 问题 (无论 是 在 试图 存储 数 
据 时 还 是 以 后 试图 处 理 数据 时 ) 。 











27.1.3 ”创建 布局 和 视图 


在 本 章 中 ， 对 于 某 些 示例 使 用 需要 简单 的 布 
局 。 创 建 Views/Shared 文 件 夹 ， 在 其 中 添加 名 为 
_Layout.cshtml 的 视图 文件 ， 内 容 如 代码 清单 27-4 所 
示 : 


代码 清单 27-4 ”Views/Shared 文 件 夹 下 的 _Layout.cshtml 文 件 的 


内 容 


<!DOCTYPE html> 
<html> 
<head> 
<meta charset="utf-8" /> 
<meta name="viewport" content="width=device-width" 
/> 
<title>Model Validation</title> 
<link asp-href-include="/1ib/bootstrap/dist/css/boo 
tstrap.min.css" rel="stylesheet" /> 
@RenderSection("scripts", false) 
</head> 
<body class="m-1 p-1"> 
@RenderBody() 
</body> 
</html> 





下 面 为 操作 方法 提供 视图 。 创 建 Views/Home 
MER, FAIA AMakeBooking.cshtml H Al 3c 


件 ， 内 容 如 代码 清单 27-5 所 示 。 


代码 清单 27-5 ”Views/Home 文 件 夹 下 的 MakeBooking.cshtml 文 
件 的 内 容 





@model Appointment 


@{ Layout = " Layout"; } 


<div class="bg-primary m-1 p-1 text-white"><h2>Book an 
Appointment</h2></div> 


<form class="m-1 p-1" asp-action="MakeBooking" method=" 
post"> 
<div class="form-group"> 
<label asp-for="ClientName">Your name:</label> 
<input asp-for="ClientName" class="form-control 
" /> 
</div> 
<div class="form-group"> 
<label asp-for="Date">Appointment Date:</label> 
<input asp-for="Date" type="text" asp-format="{ 
Q@:d}" class="form-control" /> 
</div> 
<div class="radio form-group"> 
<input asp-for="TermsAccepted" /> 
<label asp-for="TermsAccepted" class="form-chec 
k-label"> 
I accept the terms & conditions 
</label> 
</div> 
<button type="submit" class="btn btn-primary">Make 


Booking</button> 
</form> 


当 Index.cshtml 文 件 中 的 表单 被 回 发 到 应 用 程序 
时 ，MakeBooking 方 法 使 用 Views/Home 文 件 夹 中 的 
Completed 视 图 显示 用 户 创 建 的 预约 详情 ， 如 代码 
清单 27-6 所 示 。 








代码 清单 27-6 ”Views/Home 文 件 夹 下 的 Completed.cshtml 文 件 
的 内 容 





@model Appointment 
@{ Layout = " Layout"; } 


<div class="bg-success m-1 p-1 text-white"><h2>Your App 
ointment</h2></div> 


<table class="table table-bordered"> 
<tr> 
<th>Your name is:</th> 
<td>@Model.ClientName</td> 
</tr> 
<tr> 
<th>Your appontment date is:</th> 
<td>@Model.Date.ToString("d")</td> 
</tr> 
</table> 
<a class="btn btn-success" asp-action="Index">Make Anot 
her Appointment</a> 


Completed 视 图 基于 Bootstrap CSS 包 来 修饰 
HTMLA. FM AWA Ys NBootstrap, tA 
Bower Configuration File 模 板 创 建 bower.json 文 件 ， 
在 dependencies 部 分 添加 Bootstrap 包 ， 如 代码 清单 
27-7 所 示 ， 这 里 还 添加 了 jQuery 包 到 项 目 中 ， 本 章 
后 面 会 用 到 jQuery。 





代码 清单 27-7 添加 Bootstrap 包 到 bower.json 文 件 中 


{ 
"name": "asp.net", 
"private": true, 
"dependencies": { 
"bootstrap": "4.@.0-alpha.6", 
"jquery": "3.2.1" 
} 





} 


最 后 的 准备 工作 是 在 Views 文 件 夹 中 创建 
_ViewImports.cshtml 文 件 ， 在 其 中 设置 内 置 的 标签 
助手 用 于 Razor 视 图 ， 并 导入 模型 命名 空间 ， 如 代 
码 清单 27-8 所 示 。 





代码 清单 27-8 ” ”Views 文件 夹 下 的 _ViewImports.cshtml 文 件 的 内 


mL 


4S 


@using ModelValidation.Models 
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 


如 你 所 知 ， 本 草 的 示例 围绕 看 如 何 创建 预约 。 
可 以 通过 局 动 应 用 并 且 访 问 默认 URL 地 址 来 看 看 具 
体 是 如 何 工作 的 。 在 表单 中 输入 预约 详情 ， 单 击 
Make Booking 按 钮 将 数据 发 送 回 服务 器 ， 执 行 模型 
绑 定 过 程 以 创建 Appointment 对 象 ， 预 约 详情 将 使 用 
Completed 视 图 演 染 出 来 ， 如 图 27-1 所 示 。 











图 27-1 使 用 示例 应 用 


27.2 ”理解 模型 验证 的 需求 


模型 验证 是 确保 应 用 程序 从 客户 端 接 收 的 数据 
满足 要 求 的 过 程 。 没 有 验证 ， 应 用 程序 将 会 试图 处 
理 接收 的 任何 数据 ， 这 将 导致 异种 或 意外 的 行为 ， 
还 将 面临 随 着 存储 中 填充 不 民 数 据 ， 不 完整 或 恶意 
的 数据 逐渐 出 现 的 长 期 问题 。 





目前 ， 应 用 会 接收 用 户 提 交 的 任何 数据 。 为 你 
护 应 用 和 领域 模型 的 完整 性 ， 在 知道 用 户 提交 可 接 
收 的 预约 对 象 之 前 ， 需 要 做 以 下 3 件 事 : 








o ERAF 
o ARRIK H H. 
o EP AZ HENRIK o 

下 面 将 演示 如 何 使 用 模型 验证 ， 通 过 检查 应 用 
接收 的 数据 ， 以 及 在 应 用 不 能 使 用 提交 的 数据 时 为 
用 户 提 供 反 馈 来 强制 满足 这 些 要 求 。 


27.3” 显 式 地 验证 模型 





多 数 直接 验证 模型 的 途径 定义 在 操作 方法 中 ， 
在 代码 清单 27-9 所 示 的 MakeBooking 方 法 中 ， 已 加 
入 对 Appointment 类 的 每 个 属性 的 显 式 检查 。 


代码 清单 27-9 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 显 式 地 验证 模型 





using System; 

using Microsoft.AspNetCore.Mvc; 

using ModelValidation.Models; 

using Microsoft.AspNetCore.Mvc.ModelBinding; 


namespace ModelValidation.Controllers { 
public class HomeController : Controller { 
public IActionResult Index() => 
View("MakeBooking", new Appointment { Date 


= DateTime.Now }); 


[HttpPost | 
public ViewResult MakeBooking(Appointment appt) 


if (string.IsNullOrEmpty(appt.ClientName)) { 


ModelState.AddModelError (nameof (appt.Cl 
ientName), 


"Please enter your name"); 


} 


if (ModelState.GetValidationState("Date") 
== ModelValidationState.Valid && Da 
teTime.Now > appt.Date) { 
ModelState.AddModelError(nameof(appt.Da 


te), 
"Please enter a date in the future" 
)3 
if (!appt.TermsAccepted) { 
ModelState.AddModelError(nameof (appt.Te 
rmsAccepted), 


"You must accept the terms"); 


} 


if (ModelState.IsValid) { 

return View("Completed", appt); 
} else { 

return View(); 








WARE A FE as CZ T BBO RAN J VEEL 
并 使 用 从 控制 器 基 类 继承 的 ModelState 属 性 返回 的 
ModelStateDictionary 类 型 对 象 来 注册 任何 错误 。 








顾名思义 ，ModelStateDictionary 类 是 用 来 跟踪 





模型 对 象 状态 详情 的 字典 ， 主 要 用 于 验证 错误 ， 表 


> 号 


27-3 摘 述 了 ModelStateDictionary 类 的 重要 成 员 。 








表 27-3” ”ModelStateDictionary 类 的 重要 成 员 
































AddModelError(property,message) | 这 个 方法 用 于 对 特定 的 属性 记录 模型 验证 错 























这 个 方法 用 来 检测 特定 的 属性 是 否 存在 模型 验证 错误 ， 
表示 为 ModelValidationState 枚 举 中 的 值 





GetValidationState(property) 

















如 果 所 有 的 模型 属性 都 是 有 效 的 ， 那 么 这 个 属性 i 


true; 否则 ， 返 回 false 




















作为 使 用 ModelStateDictionary 的 示例 ， 考 虑 
ClientrName 属 性 是 如 何 被 验证 的 : 





if (string.IsNullOrEmpty(appt.ClientName)) { 
ModelState.AddModelError(nameof(appt.ClientName), 


Please enter your name"); 


} 





以 上 示例 中 ， 验 证 的 目标 之 一 是 确认 用 户 为 这 
个 属性 提供 了 有 效 什 ， 所 以 可 使 用 
string.ISNulOrEmpty 静 态 方法 来 测试 模型 绑 定 已 经 
从 请 求 中 提取 的 属性 值 。 如 果 ClientName 是 nul] 或 
空 串 ， 台 会 得 出 验证 目的 没有 达成 的 绪论， 然后 使 
用 ModelState.AddModelError 方 法 注册 验证 错误 信 
四 ， 指 定 属 性 的 名 字 〈ClientName) 以 及 将 会 用 来 
显示 给 用 户 以 说 明 问 题 原 因 的 信息 (Please enter 


your name) 。 














模型 绑 定 系统 还 使 用 ModelStateDictionary 记 录 
租 找 和 分 配 值 给 模型 属性 的 任何 问题 。 
GetValidationState 方 法 用 于 一 看 模型 属性 是 售 存 在 
任何 错误 ， 无 论 是 从 模型 绑 定 过 程 还 是 由 于 在 操作 
方法 中 进行 显 式 验证 期 间 调 用 了 AddModelError 方 
法 。GetValidationState 方 法 会 返回 
ModelValidationState 枚 举 中 的 一 个 值 ， 如 表 27-4 所 











人 小。 


表 27-4 ModelvalidationState 枚 举 中 的 值 


这 个 值 意 味 着 没有 在 模型 属性 上 执行 验证 ，j 
Unvalidated 
到 属性 名 称 
这 个 值 意 味 着 关联 到 属性 的 请 求 值 是 有 效 的 
这 个 值 意味 着 关联 到 属性 的 请 求 值 是 无 效 的 ， 并 


,| 这 个 人 意味 着 模型 属性 还 没有 处 理 ， 通 常 意味 着 出 现 了 太 多 的 验证 错误 
ippe 
4 至 于 无 法 继续 执行 验证 检查 


对 于 Date 属 性， 检 奏 模型 绑 定 过 程 是 否 报告 了 
关于 将 浏览 器 发 送 的 值 解析 为 DateTime 对 象 的 错 
如 下 所 示 : 
































































































































































































































if (ModelState.GetValidationState("Date") == ModelValid 
ationState.Valid 
&& DateTime.Now > appt.Date) { 
ModelState.AddModelError(nameof(appt.Date), "Please 
enter a date in the future"); 


z 


对 于 Date 属 性 ， 验 证 目标 是 确认 用 户 提 供 了 下 
确 的 未 来 日 期 。 使 用 GetValidationState 方 法 检查 
Model- ValidationState.Valid 的 值 以 判定 模型 绑 定 过 
程 能 够 解析 请 求 的 值 到 DateTime 对 象 。 如 果 存 在 有 
效 的 日 期 ， 再 确认 是 正确 的 未 来 日 期 ， 如 采 不 是 ， 
残 使 用 AddModelError 方 法 记录 存在 验证 问题 。 





在 验证 模型 对 象 的 所 有 属性 之 后 ， 检 在 
ModelState.IsSValid 属 性 以 谷 看 是 否 存 在 错误 。 如 果 
在 检查 过 程 中 ModelState.AddModelError 方 法 被 调 
用 了 ， 或 者 模型 绑 定 器 在 创建 Appointment 对 象 时 出 
现 问 题 ， 这 个 方法 将 返回 true。 











if (ModelState.IsValid) { 

return View("Completed", appt); 
} else { 

return View(); 


} 


如 果 IsValid 属 性 返回 true， 那 么 Appointment 对 
象 是 有 效 的 ， 在 这 种 情况 下 ， 操 作 方 法 泻 染 
Completed 视 图 。 如 果 IsValid 属 性 返回 false， 束 表示 
出 现 验证 问题 ， 可 通过 调用 View 方 法 来 泻 染 默认 视 
图 。 





27.3.1 为 用 户 显 示 验 证 错误 消息 








通过 调用 View 方 法 来 处 理 验 证 错误 消息 看 起 来 
很 奇怪 ，MVC 提 供给 视图 的 上 下 文 数据 中 包含 模型 
验证 错误 的 详细 信息 ， 它 们 被 自动 检测 并 由 用 于 转 
换 input 元 素 的 标签 助手 使 用 。 

















为 了 查看 具体 是 如 何 工 作 的 ， 启 动 应 用 并 在 不 
填充 任何 表单 内 容 的 情况 下 单 击 Make Booking 按 
钮 。 看 起 来 没有 任何 浏览 器 窗口 中 的 可 视 on 
变化 。 但 是 ， 如 果 查 看 MVC 为 这 个 POST 请 求 返 








的 HTML 内 容 ， 你 将 看 到 表单 元 素 的 class 属 性 发 生 
了 变化 。 以 下 是 ClientName 元 素 在 提交 表单 之 前 的 
内 容 : 








<input class="form-control" type="text" id="ClientName" 


name="ClientName" value=""> 








以 下 是 提交 空 的 表单 之 后 的 input 元 系 : 


<input class="form-control input-validation-error" type 


="text" id="ClientName" 
name="ClientName" value=""> 





Ws 2 DFA Sr ik FUE 70 8 VSS input- 
validation-error 样 式 类 ， 然 后 设置 为 同 用 户 突出 显示 
问题 。 这 可 以 通过 在 样式 表 中 定制 CSS 样 式 来 实 
现 ， 但 是 如 末 希 望 使 用 内 置 的 样式 表 ， 比 如 
Bootstrap 提 供 的 样式 表 ， 那 么 还 有 一 点 额外 的 工作 
要 人 做。 添加 到 form 元 系 的 样式 类 名 不 能 修改 ， 这 总 
味 痢 茶 些 JavaScript 代 人 码 需 要 在 MVC 使 用 的 名 称 和 和 
Bootstrap 提 供 的 CSS 错 误 类 名 之 间 进 行 映射 。 











提 7S 


AAI M JavaScript ttan] ge (Rue, BUENE 
用 Bootstrap 这 样 的 样式 库 ， 也 可 以 使 用 上 自 定 义 样 
wi. ZAIN, Bootstrap F H FEKA E BY MEH 
主题 或 者 通过 定制 包 以 及 定义 目 己 的 样式 来 覆盖 。 
这 意味 着 你 将 不 得 不 确认 对 于 主题 的 任何 修改 都 与 
目 定 义 样 式 的 相应 更 改 相 匹配 。 理 想 情 况 下 ， 微 软 
将 使 未 来 发 行 版 本 的 ASP.NET Core MVC 中 验证 类 
的 名 称 可 配置 ， 但 在 此 之 前 ， 使 用 JavaScript 来 应 用 
Bootstrap 样 式 是 比 创 建 目 定义 样式 更 加 强大 的 方 
a 


代码 清单 27-10 添 加 了 jQuery 代码 到 
MakeBooking 视 图 以 查找 拥有 inputvalidation-error 样 
式 类 的 元 素 ， 定 位 最 临近 的 被 赋予 form-group 样 式 
闫 的 父 元 素 ， 然 后 为 这 个 元 素 添 加 has-error 样 式 关 

(Bootstrap 用 它 为 form 元 素 设置 出 错 颜色 ) 。 








代码 清单 27-10 ”在 Views/Home 文 件 夹 下 的 
MakeBooking.cshtml 文 件 中 赋予 元 素 验证 类 








@model Appointment 


@{ Layout = " Layout"; } 


@section scripts { 
<script src="/1ib/jquery/dist/jquery.min.js"></scri 
pt> 
<script type="text/javascript"> 
$(document).ready(function () { 
$("input.input-validation-error" ) 
.closest(".form-group" ).addClass("has-d 


</script> 


} 


<div class="bg-primary m-1 p-1 text-white"><h2>Book an 
Appointment</h2></div> 


<form class="m-1 p-1" asp-action="MakeBooking" method=" 
post"> 
<div class="form-group"> 
<label asp-for="ClientName">Your name:</label> 
<input asp-for="ClientName" class="form-control 
" /> 
</div> 
<div class="form-group"> 
<label asp-for="Date">Appointment Date:</label> 
<input asp-for="Date" type="text" asp-format="{ 
Q@:d}" class="form-control" /> 
</div> 
<div class="radio form-group"> 
<input asp-for="TermsAccepted" /> 
<label asp-for="TermsAccepted" class="form-chec 
k-label"> 


I accept the terms & conditions 
</label> 
</div> 
<button type="submit" class="btn btn-primary">Make 
Booking</button> 
</form> 





在 浏览 器 完成 解析 HTML 文 档 中 的 所 有 元 素 之 
后 ，jQuery 代 三 被 执行 ， 效 果 是 突出 显示 被 赋予 
input- validation-error 样 式 类 的 input 元 素 。 可 以 通过 
运行 应 用 并 在 没有 填写 任何 文本 框 的 情况 下 提交 表 
单 来 查看 效果 ， 处 理 的 结果 如 图 27-2 所 示 。 














] Model Validation x 
€ C |O localhost 3 e/MakeBooking wl] = 
Book an Appointment 
Your narr le: 
Appointment Date: 
accept the terms & conditions 
Make Booking 





图 27-2 isu RUER E A 





可 在 没有 输入 任何 数据 的 情况 下 提交 表单 ， 对 
于 3 个 文本 框 ， 错 诺 消 明 都 将 突出 显示 。 除 非 提 交 
的 表 蛙 可 以 被 模型 绑 定 器 解析 ， 并 且 通 过 了 
MakeBooking 方 法 的 显 式 验证 ， 人 个 则 用 户 将 看 不 到 
Completed 视 图 。 在 此 之 前 ， 提 交 表 单 将 会 号 致使 
用 当前 验证 错误 消息 的 MakeBooking 视 图 被 泻 染 。 








27.3.2 ”显示 验证 消息 


一 些 标签 助手 应 用 到 input 元 素 的 CSS 样 式 类 标 
志 看 表单 字段 存在 问题 ， 但 是 它们 没有 告诉 用 户 是 











什么 问题 。 要 为 用 户 提供 更 加 详尽 的 消息 ， 可 使 用 
其 他 标签 助手 添加 问题 的 摘要 到 视图 中 ， 如 代码 清 
单 27-11 所 示 。 





代码 清单 27-11 在 Views/Home 文 件 夹 下 的 
MakeBooking.cshtml 文 件 中 显示 验证 摘要 








@model Appointment 


@{ Layout = " Layout"; } 


@section scripts { 

<script src="/lib/jquery/dist/jquery.min.js"></script> 

<script type="text/javascript"> 

$(document).ready(function () { 
$("input.input-validation-error") 

.closest(".form-group").addClass("has-dange 

r"); 

})3 

</script> 

} 

<div class="bg-primary m-1 p-1 text-white"><h2>Book an 

Appointment</h2></div> 


<form class="m-1 p-1" asp-action="MakeBooking" method=" 
post"> 
<div asp-validation-summary="All" class="text-dange 
r"></div> 
<div class="form-group"> 
<label asp-for="ClientName">Your name:</label> 


<input asp-for="ClientName" class="form-control 
" /> 
</div> 
<div class="form-group"> 
<label asp-for="Date">Appointment Date:</label> 
<input asp-for="Date" type="text" asp-format="{ 
Q@:d}" class="form-control" /> 
</div> 
<div class="radio form-group"> 
<input asp-for="TermsAccepted" /> 
<label asp-for="TermsAccepted" class="form-chec 
k-label"> 


I accept the terms & conditions 
</label> 
</div> 
<button type="submit" class="btn btn-primary">Make 
Booking</button> 
</form> 





ValidationSummaryTagHelper 类 监测 div 元 素 的 
asp-validation-summary 属 性 ， 通 过 添加 描述 由 操作 
方法 检测 的 任何 验证 错误 消息 进行 啊 应 。asp- 
validation-summary 属性 的 值 来 日 
ValidationSummary 枚 举 ， 如 表 27-5 所 示 。 


表 27-5 ValidationSummary 枚 举 中 的 值 





















































来 显示 所 有 被 记录 的 验证 错误 























昌 来 显示 仅 限 于 整个 模 


型 的 验证 错误 ， 不 包括 被 记录 的 属于 独立 属性 的 验证 错 























来 禁用 标签 助手 以 便 不 转换 HTML 元素 





如 有 果 运 行 应 用 ， 并 在 没有 做 任何 修改 的 情况 下 
提交 表单 ， 你 将 会 看 到 标签 助手 生成 的 摘要 信息 。 
本 示例 中 的 文本 颜色 由 text-dangerBootstrap 类 定 
义 ， 该 类 确保 文本 匹配 文本 框 中 突出 显示 的 凑 色 ， 
如 图 27-3 所 示 。 





| :| 


Book an Appointment | 


Your name: 


Appointment Date: 





| 07/08/2000 


accept the terms & conditions 
Make Booking 





图 27-3 ”为 用 户 显 示 验 证 摘要 时 文本 框 中 突出 显示 的 颜色 


如 果 但 看 浏览 絮 接 收 到 的 HTML， 你 将 会 看 到 
验证 信息 被 作为 列表 友 送 ， 像 下 面 这 样 : 


<div class="text-danger validation-summary-errors" data 
-valmsg-summary="true" > 
<ul> 
<li>Please enter your name</1i> 


<li>Please enter a date in the future</1li> 
<li>You must accept the terms</1i> 
</ul> 
</div> 





Ac RU Se fs Be Ie 


当 第 26 章 描述 的 模型 绑 定 过 程 答 试 提供 调用 操 
作 方 法 所 需 的 数据 时 ， 会 执行 目 己 的 验证 。 要 了 解 
上 其 体 是 如 何 工 作 的 ， 可 启动 应 用 ， 清 除 
Appointment Date 文 本 框 中 的 内 容 ， 然 后 提交 表 
单 。 你 将 看 到 显示 的 错误 消息 之 一 已 经 变化 ， 并 且 
与 操作 方法 中 传递 给 AddModelError 方 法 的 任何 字 
AF EB DAS DUC 


The value '' is invalid 











当 模 型 绑 定 过 程 找 不 到 属性 的 值 或 者 虽然 找到 
值 但 是 不 能 解析 时 ， 该 消息 将 被 添加 到 ModelState- 
Dictionary 中 。 在 这 个 示例 中 ， 出 现 错 误 是 因为 表 
单 中 提供 的 空 字符 串 不 能 解析 为 Appointment 对 象 的 
Date 属 性 要 求 的 DateTime 对 象 。 

















模型 绑 定 占有 一 组 用 于 验证 错误 的 预定 义 信 
思 。 通 过 将 函数 赋予 由 
DefaultModelBindingMessageProvider 类 定义 的 方 
法 ， 可 以 将 它们 登 换 为 目 定 义 的 消息 ， 如 表 27-6 所 
ZN o 


4227-6 DefaultModelBindingMessageProvider 类 定义 的 方法 





方法 


SetValueMustNotBeNullAccessor 当 非 空 的 模型 属性 值 为 空 时 ， 生 成 验证 错误 消息 


























当 请 求 中 没有 包含 必需 属性 的 值 时 ， 生 成 验证 错误 
SetMissingBindRequiredValueAccessor 消息 
1B AS 

















SetMissingKeyOrValueAccessor 当 字 典 模型 对 象 要 求 的 数据 包含 null 键 或 值 时 ， 生 
成 验证 错误 消息 























尝试 提供 给 模型 绑 定 系统 的 值 无 效 时 ， 生 成 验证 


SetAttemptedValueIsInvalidAccessor 
错误 消息 








当 模型 绑 定 系统 不 能 将 数据 值 转换 为 要 求 的 C# 类 型 


SetUnknownValuelsInvalidAccessor 


时 ， 生 成 验证 错误 消息 








不 能 被 解析 为 C# 数 值 类 型 时 ， 生 成 验证 









































SetValueMustBeANumberAccessor 


SetValuelsInvalidAccessor 生成 备用 的 验证 错误 消息 ， 用 作 最 后 的 手段 


表 27-6 中 描述 的 每 个 方法 接收 一 个 函数 ， 它 将 
锐 调 用 以 获取 显示 给 用 户 的 验证 消 奶 。 这 些 方法 用 
于 在 Startup 类 中 配置 应 用 ， 代 码 清单 27-12 蔡 换 了 当 
值 为 mul 时 的 默认 消 电 。 



























































代码 清单 27-12 ”在 ModelValidation 文 件 夹 下 的 Startup.cs 文 件 中 
蔡 换 绑 定 的 消息 





using System; 

using System.Collections.Generic; 
using System.Ling; 

using System. Threading. Tasks; 


using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
namespace ModelValidation { 


public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc().AddMvcOptions(opts => 
opts .ModelBindingMessageProvider 
.SetValueMustNotBeNullAccessor (valu 
e => "Please enter a value") 
); 
} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 








FY Fe rE FAR eC pe GE SY TELA PRI, SN IK 
YF null ste A eB. AS BRR IB rE 
的 错误 消息 ， 可 重新 局 动 应 用 并 在 清空 Appointment 
Date 文 本 框 之 后 提交 表单 ， 如 图 27-4 所 示 。 








w|i | 


idation 
€ GC | © locathos 


Book an Appointment 
e Please enter your name 
e Please enter a value 
. u must a he term: 


| 


图 27-4 ”改变 模型 绑 定 的 错误 消息 
27.3.3 ”显示 属性 级 验证 消 忆 


管 自 定义 的 错误 消 恩 比 默 认 的 更 有 意义 ， 但 
EDAREN, 因为 它 没 有 清楚 地 为 用 户 标 识 问 
题 。 对 于 这 种 错误 ， 在 包含 错误 数据 的 HTML 元 素 
劳 显示 错误 消息 更 有 帮助 ， 这 可 以 使 用 
ValidationMessageTag 标 签 助手 来 完成 ， 该 标签 助手 
将 查找 拥有 asp-validation-for 属 性 的 span 元 素 ， 该 元 
系 用 于 指定 应 显示 错误 消息 的 模型 属性 。 


代码 清单 27-13 为 表单 中 的 每 个 mput 元 系 添 加 
了 属性 级 的 验证 消 明 元素 。 这 里 还 删除 了 scripts 部 


分 ， 因 为 独立 的 验证 消 恩 将 使 验证 错误 的 元 素 足 够 


本 
m 


代码 清单 27-13 ”在 Views/Home 文 件 夹 下 的 
MakeBooking.cshtm] 文 件 中 添加 属性 级 验证 消息 





@model Appointment 


@{ Layout = " Layout"; } 


@section scripts { 

<script src="/lib/jquery/dist/jquery.min.js"></script> 

<script type="text/javascript"> 

$(document).ready(function () { 
$("input.input-validation-error") 

.closest(".form-group").addClass("has-dange 

r"); 

})3 

</script> 


} 


<div class="bg-primary m-1 p-1 text-white"><h2>Book an 
Appointment</h2></div> 


<form class="m-1 p-1" asp-action="MakeBooking" method=" 
post"> 
<div asp-validation-summary="All1" class="text-dange 
r"></div> 
<div class="form-group"> 
<label asp-for="ClientName">Your name:</label> 
<div><span asp-validation-for="ClientName" clas 


s="text-danger"></span></div> 
<input asp-for="ClientName" class="form-control 
" /> 
</div> 
<div class="form-group"> 
<label asp-for="Date">Appointment Date:</label> 
<div><span asp-validation-for="Date" class="tex 
t-danger"></span></div> 
<input asp-for="Date" type="text" asp-format="{ 
Q@:d}" class="form-control" /> 
</div> 
<span asp-validation-for="TermsAccepted" class="tex 
t-danger"></span> 
<div class="radio form-group"> 
<input asp-for="TermsAccepted" /> 
<label asp-for="TermsAccepted" class="form-chec 
k-label"> 


I accept the terms & conditions 
</label> 
</div> 
<button type="submit" class="btn btn-primary">Make 
Booking</button> 
</form> 

















由 于 span 元 素 作为 行内 元 系 显 示 ， 因 此 必须 注 
意 提 供 的 验证 消 恩 与 哪个 元 系 相 天 。 退 过 运行 应 用 
程序 并 在 不 输入 任何 数据 的 情况 下 提交 表单 ， 可 以 
看 到 新 的 验证 消息 的 影响 ， 如 图 27-5 所 示 。 





* 








图 27-5 “使 用 属性 级 验证 消息 
27.3.4 ”显示 模型 级 验证 消 忆 


验证 摘要 信息 似乎 是 多 余 的 ， 因 为 它们 仅仅 重 
a a a O 

BR ARERR, ENH EA N 
H 但 是 验证 摘要 信息 有 显示 用 于 整个 模型 的 信息 
的 能 力 ， 这 意味 看 可 以 报告 由 组 合 的 单个 属性 引起 
的 错误 ， 例 如 ， 在 给 定 的 日 期 仅仅 对 特定 名 称 的 组 
合 才 有 效 的 情况 下 。 


代码 清单 27-14 添 加 了 验证 检查 ， 用 来 阻止 名 
为 Joe 的 客户 于 星期 一 的 预约 。 








代码 清单 27-14 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 执行 模型 级 验证 





using System; 

using Microsoft.AspNetCore.Mvc; 

using ModelValidation.Models; 

using Microsoft.AspNetCore.Mvc.ModelBinding; 


namespace ModelValidation.Controllers { 
public class HomeController : Controller { 


public IActionResult Index() => 
View("MakeBooking", new Appointment() { Dat 
e = DateTime.Now }); 
[HttpPost ] 
public ViewResult MakeBooking(Appointment appt) 


if (string. IsNullOrEmpty(appt.ClientName) ) 
{ 
ModelState.AddModelError(nameof(appt.Cl 
ientName) , 
"Please enter your name"); 


} 


if (ModelState.GetValidationState("Date") 
== ModelValidationState.Valid && Da 
teTime.Now > appt.Date) { 


ModelState.AddModelError(nameof(appt.Da 


te), 
"Please enter a date in the future" 
) 
} 
if (!appt.TermsAccepted) { 
ModelState.AddModelError(nameof(appt.Te 
rmsAccepted), 
"You must accept the terms"); 
} 
if (ModelState.GetValidationState(nameof (ap 
pt .Date) ) 


== ModelValidationState. Valid 
&& ModelState.GetValidationState(nameof 
(appt.ClientName ) ) 
== ModelValidationState. Valid 
&& appt.ClientName.Equals("Joe", String 
Comparison.OrdinallIgnoreCase) 
&& appt.Date.DayOfWeek == DayOfWeek.Mon 
day) { 
ModelState.AddModelError("", 
"Joe cannot book appointments o 
n Mondays"); 


} 


if (ModelState.IsValid) { 

return View( "Completed", appt); 
} else { 

return View(); 








这 段 代 码 看 起 来 比 实 际 上 要 复杂 ， 这 是 数据 验 
证 的 特点 。 通 过 检查 模型 状态 ， 确 认 已 经 收 到 有 效 
的 ClientrName 和 Date 值 ， 然 后 检查 特定 的 日 期 是 否 
为 星期 一 ， 以 及 ClientName 属 性 的 值 是 否 为 Joe。 如 
果 Joe 试 图 于 星期 一 预约 ， 那 么 使 用 空 字符 串 C 
") 作为 第 一 个 参数 来 调用 AddModelError 方 法 ， 这 
表示 错误 将 应 用 于 整个 模型 而 不 是 单个 属性 。 














代码 清 单 27-15 通 过 将 asp-validation-summary 属 
性 的 值 改 为 ModelOnly， 排 除了 属性 级 别 的 错误 消 
娠 ， 这 意味 着 摘要 将 仪 仪 显示 应 用 于 整个 模型 的 错 


TRIB o 








代码 清单 27-15 “在 Views/Home 文 件 夹 下 的 
MakeBooking.cshtml 文 件 中 显示 模型 级 验证 错误 








@model Appointment 


@{ Layout = " Layout"; } 


@section scripts { 


<script src="/lib/jquery/dist/jquery.min.js"></script> 
<script type="text/javascript"> 
$(document).ready(function () { 
$("input.input-validation-error") 
.closest(".form-group").addClass("has-dange 
r"); 
}); 
</script> 


} 


<div class="bg-primary m-1 p-1 text-white"><h2>Book an 
Appointment</h2></div> 


<form class="m-1 p-1" asp-action="MakeBooking" method=" 
post"> 
<div asp-validation-summary="ModelOnly" class="text 
-danger"></div> 
<div class="form-group"> 
<label asp-for="ClientName">Your name:</label> 
<div><span asp-validation-for="ClientName" clas 
s="text-danger"></span></div> 
<input asp-for="ClientName" class="form-control 
" /> 
</div> 
<div class="form-group"> 
<label asp-for="Date">Appointment Date:</label> 
<div><span asp-validation-for="Date" class="tex 
t-danger"></span></div> 
<input asp-for="Date" type="text" asp-format="{ 
Q@:d}" class="form-control" /> 
</div> 
<span asp-validation-for="TermsAccepted" class="tex 
t-danger"></span> 
<div class="radio form-group"> 
<input asp-for="TermsAccepted" /> 
<label asp-for="TermsAccepted" class="form-chec 


k-label"> 


I accept the terms & conditions 
</label> 


</div> 


<button type="submit" class="btn btn-primary">Make 
Booking</button> 


</form> 





通过 运行 应 用 可 以 得 看 效果 ， 输 入 Joe 到 Your 
name 文 本 框 中 ， 选 择 预约 日 期 为 0118/2027， 提 交 
表单 ， 你 将 看 到 图 27-6 所 示 的 响应 。 
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图 27-6 “响应 
27.4 使 用 元 数据 指定 验证 规则 


将 验证 逻辑 放 入 操作 方法 的 问题 是 会 在 每 个 接 











收 数据 的 操作 方法 中 导致 重复 。 为 了 减少 重复 ， 验 
证 过 程 文 持 使 用 特性 直接 在 模型 关中 表达 验证 规 
则 ， 确 保 无 论 哪个 操作 方法 用 来 处 理 请 求 ， 都 使 用 
相同 的 一 组 验证 规则 ， 











代码 清单 27-16 已 在 Appointment 类 中 应 用 验证 
特性 以 实施 属性 级 验证 规则 。 


代码 清单 27-16 ”在 Models 文 件 夹 下 的 Appointment.cs 文 件 中 应 
用 验证 特性 





using System; 
using System.ComponentModel.DataAnnotations; 


namespace ModelValidation.Models { 
public class Appointment { 
[Required ] 
[Display(Name = "name") ] 


public string ClientName { get; set; } 


[UIHint( "Date" ) ] 
[Required(ErrorMessage = "Please enter a date") ] 


public DateTime Date { get; set; } 
[Range(typeof(bool), "true", "true", 


ErrorMessage = "You must accept the terms") ] 
public bool TermsAccepted { get; set; } 








以 上 代码 使 用 了 两 个 验证 特性 Required 和 
Range. Required} EJK ve SWRA PRA NIE 
供 值 ， 就 是 验证 错误 。Range 特 性 指定 了 可 接收 的 
子 集 。 表 27-7 展 示 了 MVC 应 用 中 内 置 的 验证 特性 。 














表 27-7 内 置 的 验证 特性 


ai 


这 个 特性 确保 属性 拥有 相同 的 值 ， 当 要 求 
Compare [Compare("OtherProperty")] | 用 户 提 供 两 次 相同 的 信息 时 很 有 用 ， 比 如 
电子 邮件 地 址 或 口令 

































































































































































这 个 特性 确保 数值 (或 者 任何 实现 了 
IComparable 的 属性 类 型 ) 不 超出 指定 的 最 
Range [Range(10,20)] 小 值 和 最 大 值 。 为 了 仅 指 定单 侧 边界 ， 可 
使 用 MinValue 或 MaxValue 常 量 ， 例 如 
[Range(int.MinValue,50)] 


这 个 特性 确保 字符 串 值 与 指定 的 正则 表达 


























式 匹配 。 注 意 ， 模 式 必须 匹配 整个 用 户 提 
RegularExpression | [RegularExpression 供 的 值 ， 而 不 仅仅 是 其 中 的 子 串 。 默 认 情 






































("pattern") | 况 下 ， 匹 配 时 区 分 大 小 写 ， 但 可 以 通过 应 
FA Ci) 修饰 符 〈 如 [RegularExpression("(? 
i)mypattern")]) 来 不 区 分 大 小 写 











这 个 特性 确保 值 不 为 空 或 是 仅仅 包含 空格 








[Required] 的 字符 串 。 如 果 要 将 空格 视 为 肥效， 请 使 
用 [Required (AllowEmptyStrings = true) ] 





这 个 特性 确保 字符 串 的 值 不 长 于 指定 的 最 
StringLength [StringLength(10)] 大 长 度 ， 还 可 以 指定 最 小 长 度 ， 如 
[StringLength(10,MinimumLength=2)] 














所 有 的 验证 特性 都 文 持 通过 为 ErrorMessage 属 
性 设置 值 来 定制 错误 消息 ， 类 似 于 下 面 这 样 : 


[UIHint ("Date") ] 


[Required(ErrorMessage = "Please enter a date") ] 
public DateTime Date { get; set; } 





如 采 这 里 没有 定制 错误 消息 ， 那 么 默认 的 信息 
将 被 应 用 ， 但 是 它们 倾 问 于 显示 对 用 户 没 有 意义 的 
模型 类 的 详细 信息 ， 除 非 还 使 用 Display 特 性 ， 并 组 
合 应 用 于 ClientName 属 性 。 








[Required ] 
[Display(Name = "name")] 


public string ClientName { get; set; } 





i Required FF HEE MAIER UGE SBR 48 A 
Display 特 性 指定 的 名 称 ， 因 此 不 会 将 属性 的 名 称 显 
示 给 用 户 。 





需要 注意 使 验证 保持 一 致 ， 例 如 ， 考 虑 应 用 于 
TermAccepted 属 性 的 特性 : 


[Range(typeof(bool), "true", "true", ErrorMessage="You 
must accept the terms") ] 


public bool TermsAccepted { get; set; } 





RATIA BEA PF ae RAER H 
不 能 使 用 Required 特 性 ， 因 为 如 果 用 户 没 有 选中 复 
选 框 ， 浏 览 占 将 为 这 个 属性 发 送 false 值 。 为 了 统 过 
这 个 问题 ， 可 使 用 Range 特 性 的 一 项 功能 : 提供 





Type， 并 将 上 限 和 下 限 指定 为 字符 串 值 。 通 过 设置 
两 个 界限 都 为 tue， 为 基于 复 选 框 的 bool 属 性 创建 
Required 特 性 的 等 价 物 。 这 可 能 需要 做 一 些 实验 ， 
以 确保 浏览 器 发 送 的 验证 特性 和 数据 一 起 工作 。 





在 模型 类 上 使 用 验证 特性 意味 着 控制 器 中 的 操 
作 方法 可 以 简化 ， 如 代码 清单 27-17 所 示 。 


代码 清单 27-17 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 移 除 属性 级 验证 





using System; 

using Microsoft.AspNetCore.Mvc; 

using ModelValidation.Models; 

using Microsoft.AspNetCore.Mvc.ModelBinding; 


namespace ModelValidation.Controllers { 
public class HomeController : Controller { 
public IActionResult Index() => 
View("MakeBooking", new Appointment() { Dat 


e = DateTime.Now }); 


[HttpPost ] 
public ViewResult MakeBooking(Appointment appt) 


if (ModelState.GetValidationState(nameof (ap 
pt .Date) ) 
== ModelValidationState. Valid 
&& ModelState.GetValidationState(nameof 
(appt.ClientName) ) 
== ModelValidationState. Valid 
&& appt.ClientName.Equals("Joe", String 
Comparison.OrdinallIgnoreCase) 
&& appt.Date.DayOfWeek == DayOfWeek.Mon 
day) { 
ModelState.AddModelError("", 
"Joe cannot book appointments on Mo 
ndays"); 


if (ModelState.IsValid) { 

return View("Completed", appt); 
} else { 

return View(); 








验证 特性 在 调用 操作 方法 之 前 被 应 用 ， 这 意味 
着 可 以 仍然 基于 模型 来 确定 在 执行 模型 验证 时 单个 
属性 是 否 有 效 。 下 面 在 操作 方法 中 查看 验证 特性 
启动 应 用 ， 然 后 不 输入 任何 数据 就 提交 表单 ， 如 图 
27-7 上 所 示 。 
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I terms & conditions 
Make Booking 


图 27-7 使 用 验证 特性 
创建 目 定 义 的 属性 验证 特性 


验证 过 程 可 以 通过 创建 实现 了 IModelValidator 
接口 的 特性 来 扩展 。 为 了 展示 ， 创 建 Infrastructure 
文件 夹 ， 然 后 添加 一 个 名 为 MustBeTrueAttribute.cs 
的 类 了 文件， 定义 代码 清单 27-18 所 示 的 类 。 


代码 清单 27-18 ”Infrastructure 文 件 夹 下 的 
MustBeTrueAttribute.cs 文 件 的 内 容 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using Microsoft.AspNetCore.Mvc.ModelBinding.Validation; 


namespace ModelValidation.Infrastructure { 
public class MustBeTrueAttribute : Attribute, IMode 
lValidator { 


public bool IsRequired => true; 


public string ErrorMessage { get; set; } = "Thi 
s value must be true"; 


public IEnumerable<ModelValidationResult> Valid 


ate( 
ModelValidationContext context) { 
bool? value = context.Model as bool?; 
if (!value.HasValue || value.Value == false 
ee 
return new List<ModelValidationResult> 
{ 
new ModelValidationResult("", Error 
Message) 
}; 
} else { 
return Enumerable.Empty<ModelValidation 
Result>(); 





IModelValidator 接 口 定 义 了 名 为 ISRequired 的 属 





性 ， 用 于 指示 是 售 需 要 验证 该 类 《这 里 有 一 点 误 


导 ， 因 为 这 个 属性 返回 的 值 仅仅 被 用 于 排序 验证 特 


性 ， 以 便 需 要 的 先 执行 ) 。Validate 方 法 用 来 执行 
验证 并 通过 ModelValidationContext 类 的 实例 接收 信 
恩 ， 该 类 定义 的 主要 属性 如 表 27-8 所 示 。 


表 27-8 ModelvalidationContext 关 定义 的 属性 




















返回 被 验证 的 属性 值 ， 在 示例 中 是 TermsAccepted 属 性 以 
mane 全 属性 的 对 象 ， 在 示例 中 是 Appointment 对 象 































































































返回 ActionContext 对 象 ， 该 对 象 提 供 上 下 文 数 据 ， 并 描述 将 处 理 请 求 的 操 
作 方 法 


ModelMetadata | 返回 ModelMetadata 对 象 ， 该 对 象 描 述 用 于 进行 详细 验证 以 


Validate 方 法 返回 一 个 ModelValidationResult 对 
象 序列 ， 其 中 每 一 个 对 象 描述 了 一 个 验证 错误 。 在 
示例 特性 中 ， 如 采 模 型 值 不 是 真 的 ， 束 创建 
ModelValidationResult。ModelValidationResult 构 造 
函数 的 第 一 个 参数 是 属性 的 名 称 ， 访 属性 与 错误 是 





ActionContext 






























































相关 联 的 。 当 验证 每 个 错误 的 时 候 ， 指 定 该 属性 是 
空 字 符 串 。 错 误 消 息 的 第 二 个 参数 是 显示 给 用 户 的 
普 误 消 息 。 在 代码 清单 27-19 中 ， 用 自 定 义 特 性 蔡 
换 了 Range 特 性 。 


























代码 清单 27-19 在 Models 文 件 夹 中 应 用 Appointment.cs 文 件 中 
的 目 定义 验证 特性 





using System; 
using System.ComponentModel.DataAnnotations; 
using ModelValidation. Infrastructure; 


namespace ModelValidation.Models { 
public class Appointment { 


[Required] 
[Display(Name = "name")] 
public string ClientName { get; set; } 


[UIHint("Date")] 
[Required(ErrorMessage = "Please enter a date") 


public DateTime Date { get; set; } 


[MustBeTrue(ErrorMessage = "You must accept the 
terms")] 
public bool TermsAccepted { get; set; } 


} 


使 用 自 定 义 的 验证 特性 的 结果 与 使 用 Range 特 
性 的 结 末 相同 ， 但 是 在 阅读 代码 时 ， 目 定义 特性 更 
加 容易 理解 。 


27.5 HÍT Z P m ee UE 








到 目前 为 止 ， 己 展示 的 验证 撤 术 者 是 服务 融 冰 
验证 方面 的 ， 这 意味 着 用 户 提 区 数据 到 服务 大 ， 然 
后 服务 占 验 证 数据 并 返回 验证 结果 (不 省 是 成 功 处 
理 数据 还 是 需要 更 正 的 错误 列表 ) 。 














在 Web 应 用 中 ， 用 户 通 党 需要 立即 得 到 验证 回 
Vt, MAC ARS ae TEAC ELTA, RRA Pi 
验证 ， 并 使 用 JavaScript 来 实现 。 用 户 输入 的 数据 在 
有 发送 到 服务 器 之 前 被 验证 ， 为 用 户 提 供 即 时 反 蚀 并 
有 机 会 更 正 任 何 错误 。 











MVC 支 持 无 痕 的 客户 端 验证 。 无 痕 意 味 着 使 
用 视图 生成 的 、 添 加 到 HTML 元 素 的 属性 来 表示 验 
证 规则 。 这 些 属性 由 作为 MVC 一 部 分 的 JavaScript 
库 进 行 解释 ， 反 过 来 ， 配 置 执行 实际 验证 工作 的 
jQuery 验证 库 。 后 面 将 展示 内 置 的 验证 文 持 如 何 工 
作 ， 并 展示 如 何 扩展 它 的 功能 以 文 持 目 定 义 的 客户 
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第 一 步 是 使 用 Bower 将 新 的 JavaScript 包 加 入 应 
用 ， 如 代码 清单 27-20 所 示 。 


代码 清单 27-20 ”在 ModelValidation 文 件 夹 下 的 bower.json 文 件 
中 添加 包 


{ 


"name": "asp.net", 
"private": true, 
"dependencies": { 
"bootstrap": "4.0.@-alpha.6", 
"jquery"”: "3.2.1", 
"jquery-validation": "1.17.0", 
"jquery-validation-unobtrusive": "3.2.6" 











使 用 客户 并 验证 意味 着 将 3 个 JavaScript 文 件 
一 jQuery 库 、jQuery 验 证 库 和 微软 无 痕 验 证 库 添 
加 到 视图 中 ， 所 有 这 些 如 代码 清单 27-21 所 示 。 





二 


提 示 


Bower 工 具 不 会 始终 正确 地 安装 验证 包 。 如 果 
你 发 现 wwwrootlib 文 件 夹 不 包含 需要 的 文件 ， 那 么 
可 以 删除 wwwrooUlib 及 其 内 容 。 打 开 新 的 
PowerShell 窗口 ， 找 到 项 目 文件 夹 ， 运 行 bower 
cache clean 和 bower install， 下 载 验 证 包 的 新 副本 。 





代码 清单 27-21 在 Views/Home 文 件 夹 下 的 
MakeBooking.cshtml 文 件 中 添加 验证 脚本 元 素 





@model Appointment 


@{ Layout = " Layout"; } 


@section scripts { 


<script src="/lib/jquery/dist/jquery.min.js"></scri 
pt> 

<script src="/1ib/jquery-validation/dist/jquery.val 
idate.min.js"></script> 

<script 

src="/1lib/jquery-validation-unobtrusive/jquery. 

validate.unobtrusive.min.js"> 

</script> 


} 


<div class="bg-primary m-1 p-1 text-white"><h2>Book an 
Appointment</h2></div> 


<form class="m-1 p-1" asp-action="MakeBooking" method=" 
post"> 
<div asp-validation-summary="ModelOnly" class="text 
-danger"></div> 
<div class="form-group"> 
<label asp-for="ClientName">Your name:</label> 
<div><span asp-validation-for="ClientName" clas 
s="text-danger"></span></div> 
<input asp-for="ClientName" class="form-control 
" /> 
</div> 
<div class="form-group"> 
<label asp-for="Date">Appointment Date:</label> 
<div><span asp-validation-for="Date" class="tex 
t-danger"></span></div> 
<input asp-for="Date" type="text" asp-format="{ 
Q@:d}" class="form-control" /> 
</div> 
<span asp-validation-for="TermsAccepted" class="tex 
t-danger"></span> 
<div class="radio form-group"> 
<input asp-for="TermsAccepted" /> 
<label asp-for="TermsAccepted" class="form-chec 


k-label"> 


I accept the terms & conditions 
</label> 
</div> 
<button type="submit" class="btn btn-primary">Make 
Booking</button> 
</form> 





这 些 文件 必须 按照 顺序 添加 。 当 使 用 标签 助手 
转换 input 元 又 的 时 候 ， 它 们 会 检查 应 用 与 全 型 其 的 
验证 特性 并 同 输 出 元 素 添 加 属性 。 如 朱 运 行 应 用 并 
检查 发 送 到 浏览 器 的 HIML， 你 将 会 看 到 类 似 于 下 
面 这 样 的 元 系 : 





<input class="form-control" type="text" data-val="true" 
data-val-required="The name field is required." id= 


"ClientName" 
name="ClientName" value="" /> 





JavaScript 代 码 使 用 data-val 属 性 来 查找 元 素 ， 
并 在 用 户 提 交 表 单 时 在 浏览 器 中 执行 本 地 验证 ， 而 
不 向 服务 器 发 送 HTTP 请 求 。 在 使 用 F12 键 时 ， 可 以 
通过 运行 应 用 和 提交 表单 来 查看 效果 。 注 意 ， 即 使 














把 HITP 请 求 有 故 送 到 服务 右 ， 也 会 显示 验证 错误 消 
自 


4D oO 


避免 与 浏览 器 验证 发 生 冲 突 


当前 的 一 些 HIML5 浏 览 器 文 持 基于 input 元 素 
属性 的 简单 客户 端 验证 。 人 例如， 如果 为 input 元 系 应 
用 了 required 属 性 ， 那 么 当 用 户 试 图 在 不 提供 值 的 
情况 下 提交 表单 时 ， 会 导致 浏览 器 显示 验证 错误 。 


如 采 从 模型 中 生成 表单 元 素 ， 那 么 浏览 器 验证 
将 不 会 有 任何 问题 ， 因 为 MVC 将 生成 和 使 用 data- 属 
性 来 表示 验证 规则 例如， 为 必须 上 共有 值 的 input 元 
际 使 用 data-val-required 必 性， 浏览 右 将 不 会 识别 议 
yr 


但 是 ， 如 采 无 法 完全 控制 应 用 程序 中 的 标记 ， 


那么 你 可 能 会 遇 到 问题 。 当 你 处 理 以 其 他 途径 生成 
的 内 容 时 ， 通 党 会 发 生 这 种 错误 。 结 果 是 jQuery 验 
证 和 浏览 器 验证 同时 作用 于 表单 ， 对 用 户 造 成 困 
扰 。 为 避免 此 类 问题 ， 可 以 将 novalidate 属 性 添加 到 
form 元 素 中 。 


MVC 客 户 问 验证 的 一 个 很 好 特性 是 用 来 指定 
验证 规则 的 属性 可 同时 应 用 于 客户 端 和 服务 器 病 ， 
这 意味 着 来 日 不 支持 JavaScript 的 浏览 器 的 数据 将 受 
同样 的 验证 ， 而 不 需要 做 任何 额外 的 工作 。 但 是 ， 
这 也 意味 着 客 户 尊 验证 不 文 持 目 定 义 的 验证 特性 ， 
因为 JavaScript 无 法 在 客户 端 实 现 自 定义 验证 逻辑 。 
换 句 话说 ， 如 采 要 使 用 客户 端 验证 ， 则 需要 遵守 表 
27-7 中 描述 的 内 置 特性 。 








比较 MVC 客 户 端 验证 与 jQuery 验证 


MVC 客 户 端 验证 建立 在 jQuery 验证 库 之 上 。 如 
果 愿 意 ， 你 可 以 直接 使 用 验证 库 而 急 略 MVC 特 性 。 
验证 库 不 仅 灵 活 而 且 功 能 丰富。 如 有 果 仅 仅 期 望 理解 
如 何 自 定义 MVC 特 性 以 最 大 限度 利用 可 用 的 验证 选 
项 ， 这 是 值得 的 。Pro jQuery 2.0 一 书 深入 介绍 了 
jQuery 验证 库 。 











27.6 ”执行 远程 验证 


本 章 将 要 摘 述 的 最 后 一 个 验证 特性 是 远程 验 
证 。 这 是 一 种 客户 冯 验 证 撤 术 ， 可 以 通过 调用 服务 
Ar Im IERIE T IA RAIT IUE o 


远程 验证 的 第 见 示 例 是 在 应 用 中 检查 用 户 名 是 
售 可 用 ， 这 些 名 称 必 须 是 唯一 的 ， 用 户 提交 数据 ， 


然后 执行 客户 剖 验 证 。 作 为 处 理 的 一 部 分 ， 问 服务 
髓 及 出 Ajax 请 求 以 验证 请 求 的 用 户 名 。 如 宋 用 户 和 名 
己 经 被 占用 ， 则 显示 验证 错误 以 便 用 户 和 输入 另外 的 
名 称 。 








IAA) HEA ERKAT E LARA ae SEE, {EL 
这 种 方法 有 一 些 好 处 。 首 先 ， 仅 有 少量 属性 被 远程 
验证 ;客户 端 验证 的 好 处 仍然 适用 于 用 户 输入 的 所 
有 其 他 属性 值 。 其 次 ， 请 求 是 轻 量 级 的 并 专注 村 验 
证 ， 而 不 是 处 理 整 个 模型 对 象 。 














远程 验证 在 后 合 执行 ， 用 户 不 需要 单 击 提交 鬼 
钮 并 等 竺 新 的 视图 被 泻 染 和 返回 。 这 使 得 用 户 体验 
更 好 ， 尤 其 是 在 浏览 莫 和 服务 右 之 间 网 速 较 慢 的 时 
候 。 











ated, ORES UE SD, ETERS PR vin Sor 
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应 用 服务 耸 发 出 请 求 ， 因 而 不 像 通 癌 的 客户 站 验证 
那样 快速 。 


使 用 远程 验证 的 第 一 步 是 创建 一 个 可 以 验证 模 
型 属性 的 操作 方法 ， 下 面 将 验证 Appointment 模 型 的 
Date 属 性 来 确保 请 求 的 预约 发 生 在 未 来 〈 这 是 本 章 
开头 使 用 的 原 有 验证 规则 之 一 ， 但 是 不 可 能 使 用 标 
准 的 客户 姗 验证 特性 来 实现 ) 。 代 码 清单 27-22 展 
示 了 如 何 将 操作 方法 ValidateDate 添 加 到 Home 控 制 
fit Fo 

代码 清单 27-22 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 加 入 验证 用 的 操作 方法 





using System; 

using Microsoft.AspNetCore.Mvc; 

using ModelValidation.Models; 

using Microsoft.AspNetCore.Mvc.ModelBinding; 
namespace ModelValidation.Controllers { 


public class HomeController : Controller { 


public IActionResult Index() => 
View("MakeBooking", new Appointment() { Dat 


e = DateTime.Now }); 


[HttpPost ] 
public ViewResult MakeBooking(Appointment appt) 
{ 
if (ModelState.GetValidationState(nameof (ap 
pt.Date) ) 


== ModelValidationState. Valid 
&& ModelState.GetValidationState(nameof 
(appt.ClientName) ) 
== ModelValidationState.Valid 
&& appt.ClientName.Equals("Joe", String 
Comparison.OrdinallIgnoreCase) 
&& appt.Date.DayOfWeek == DayOfWeek.Mon 


day) { 
ModelState.AddModelError("", 
"Joe cannot book appointments on Mo 
ndays"); 
} 
if (ModelState.IsValid) { 
return View("Completed", appt); 
} else { 
return View(); 
} 
} 
public JsonResult ValidateDate(string Date) { 
DateTime parsedDate; 
if (!DateTime.TryParse(Date, out parsedDate 
)) { 


return Json("Please enter a valid date 


(mm/dd/yyyy)"); 
} else if (DateTime.Now > parsedDate) { 


return Json("Please enter a date in the 


future"); 
} else { 
return Json(true) ; 





文 持 远程 验证 的 操作 方法 必须 返回 JsonResult 
类 型 ， 以 告诉 MVC 正 在 使 用 JSON 数 据 。 如 第 20 章 
所 述 ， 除 结果 之 外 ， 验 证 用 的 操作 方法 必须 定义 与 
要 验证 的 数据 字段 同名 的 参数 。 对 于 这 个 示例 来 
说 ， 在 操作 方法 内 部 ， 通 过 将 值 解析 为 DateTime 对 
象 并 检查 是 否 为 未 来 的 时 间 来 执行 验证 。 





Pp 
提示 


你 可 以 利用 模型 绑 定 珊 来 的 好 处 将 操作 方法 的 


参数 定义 为 DateTime 对 象 ， 但 是 这 样 做 意味 着 如 采 
用 户 输入 没有 意义 的 值 ， 比 如 apple， 验 证 方法 将 无 
法 处 理 。 这 是 因为 模型 绑 定 器 无 法 从 apple 创 建 
DateTime 对 象 ， 并 在 试图 处 理 时 抛 出 异常 。 远 程 验 
证 没有 办 法 表达 这 个 寞 闸 ， 因 此 被 无 提示 地 丢 莽 。 
这 导致 不 能 突出 显示 数据 字段 的 未 预期 结果 ， 产 生 
用 户 输 入 的 数据 是 有 效 的 印象 。 作 为 一 役 规则 ， 远 
程 验证 的 最 佳 方法 是 在 操作 方法 中 接收 字符 串 类 型 
的 参数 ， 并 执行 显 式 的 类 型 转换 、 解 析 或 模型 绑 


ry 


KE o 





使 用 Json 方 法 可 以 表达 验证 结果 ，Json 方 法 创 
建 了 客户 闹 远 程 验证 脚本 可 以 解析 和 处 理 的 JSON 
格式 的 结果 。 如 果 什 是 有 效 的 ， 就 将 true 作 为 参数 
传递 给 Json 方 法 ， 如 下 上 所 示 : 


return Json(true) ; 








OAR A ell, RURAL MZA N See es 
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return Json("Please enter a date in the future"); 





为 了 使 用 远程 验证 方法 ， 可 在 模型 类 的 属性 上 
应 用 Remote 特 性 ， 如 代码 清单 27-23 所 示 。 


代码 清单 27-23 ”在 Models 文 件 夹 下 的 Appointment.cs 文 件 中 使 
用 Remote 特 性 





using System; 

using System.ComponentModel .DataAnnotations; 
using ModelValidation.Infrastructure; 

using Microsoft.AspNetCore.Mvc; 


namespace ModelValidation.Models { 
public class Appointment { 


[Required | 


[Display(Name = "name") ] 
public string ClientName { get; set; } 


[UIHint("Date") ] 
[Required(ErrorMessage = "Please enter a date") 


[Remote("ValidateDate", "Home") ] 

public DateTime Date { get; set; } 

[MustBeTrue(ErrorMessage = "You must accept the 
terms") ] 

public bool TermsAccepted { get; set; } 


} 








Remote 特 性 的 参数 是 用 于 生成 JavaScript 验 证 
库 将 要 调用 的 URL 以 便 执 行 验证 的 操作 方法 名 称 和 
控制 器 名 称 ， 在 本 例 中 是 Home 控 制 右 的 
ValidateDate 方 法 。 








启动 应 用 ， 导 航 到 /Home 并 输入 过 去 的 日 期 来 
得 看 远程 验证 如 何 工 作 。 当 你 选择 一 个 值 并 将 焦点 
转移 到 另外 一 个 元 素 时 ， 将 会 显示 验证 消息 ， 如 图 
27-8 所 示 。 


wl i 








01/01/2000 


© laccept the terms & conditions 





图 27-8 执行 远程 验证 
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在 用 户 首次 提交 表单 以 及 以 后 每 次 编辑 数据 
时 ， 都 会 调用 验证 用 的 操作 方法 。 对 于 文本 类 型 的 
input 元 素 ， 每 次 单 击 都 将 导致 调用 到 服务 器 。 对 于 
某 些 应 用 ， 这 可 能 是 大 量 请 求 ， 在 生产 中 指定 服务 
器 容量 和 带宽 时 必须 考虑 这 些 请 求 。 此 外 ， 可 以 选 








择 不 对 验证 成 本 高 昂 的 属性 使 用 远程 验证 《例如 ， 
当 必 须 碍 询 较 慢 的 服务 问 以 确定 用 户 名 是 售 唯 一 
HFF + 


27.7 小 结 





本 章 说 明了 可 用 于 执行 模型 验证 的 各 种 技术 ， 
确保 用 户 提 供 的 数据 与 对 数据 模型 的 约束 一 致 。 模 
型 验证 是 一 个 重要 的 话题 ， 为 应 用 得 到 正确 的 验证 
对 于 确保 用 户 具 有 民 好 和 无 挫 败 感 的 体验 至 关 重 
要 。 下 一 章 将 说 明 如 何 使 用 ASP.NET Core Identity 
来 保 扩 MVC 应 用 程序 。 





第 28 章 “ASP.NET Core Identity 入 门 


ASP.NET Core Identity 是 来 目 微 软 的 用 于 在 
ASP.NET 应 用 程序 中 管理 用 户 的 API。 本 章 将 演示 
它 的 设置 过 程 ， 并 创建 一 个 简单 的 用 户 官 理工 具 来 
管理 存储 在 数据 库 中 的 独 并 用 户 账户 。 








ASP.NET Core Identity 也 支持 其 他 类 型 的 用 户 
账户 ， 比 如 存储 在 活动 目录 中 的 用 户 账 户 ， 但 不 会 
描述 它们 ， 因 为 它们 不 经 常用 于 企业 之 外 的 环境 

(活动 目录 的 实现 往往 很 复 休 ， 很 难 提供 有 用 的 通 
用 示例 ) 。 











注 Ë 
本 章 要 求 为 Visual Studio 安 装 SQL Server 
LocalDB 功 能 。 可 以 通过 运行 Visual Studio 安 装 器 和 


安装 Microsoft SQL Server Data Tools KX JNSQL 


Server LocalDB. 


第 29 章 将 展示 如 何 使 用 这 些 用 户 账 户 执行 号 份 
验证 和 授权 ， 第 30 章 将 展示 如 何在 这 些 基 础 之 上 应 
级 技术 。 表 28-1 提 供 了 关于 ASP.NET Core 
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Identity 的 问题 。 
表 28-1 关于 ASP.NET Core Identity 的 问题 


旧 户 数据 存储 





ASP.NET Core Identity 是 管理 用 户 并 通过 Entity Framework Core 将 月 


到 诸如 数据 库 的 存储 库 中 的 API 

















AYE | 对 于 大 多 数 应 用 程序 来 说 ， 用 户 管 理 是 重要 的 功能 。ASP.NET Core Identity 提 供 
H? 了 现成 的 和 经 过 良好 测试 的 平台 ， 对 于 常见 功能 甚至 不 需要 创建 自 定义 的 版 本 












































过 添加 到 Startup 类 的 服务 和 中 间 件 ， 以 及 作为 应 用 和 ASP.NET Core Identity 
hai oi 




















ASP.NET Core Identity 更 加 灵活 且 可 配置 ， 能 够 弥补 早期 的 ASP.NET 用 户 管理 
API 的 不 足 




















陷 或 限 
fi]? 








可 以 实现 自己 的 API， 但 是 需要 做 大 量 的 工作 ， 而 且 除 非 非常 小 心 ， 否 则 可 能 
致 安全 漏洞 











表 28-2 列 出 了 本 章 要 介绍 的 操作 。 


表 28-2 本章 要 介绍 的 操作 























为 项 目 添 加 为 ASP.NET Core Identity 和 Entity Framework Core 添 加 包 | 代码 清单 28-1 
ASP.NET Core FP 间 件 ， 创 建 用 户 类 和 数据 库 上 下 文 类 ， 创 建 数据 库 | 一 代码 清单 28- 
Identity 迁移 13 












































代码 清单 28-14 
更 用 上下文 类 查询 ASP.NET Core Identity 数 据 库 和 代码 清单 28- 
15 



































代码 清单 28-16 
创建 用 户 账户 “| 调用 UserManager.CreateAsync 方 法 一 代码 清单 28- 
18 





























在 Startup 类 中 设置 密码 配置 








代码 清单 28-20 
一 代码 清单 28- 
22 








实现 自 定义 密 “| 实现 IPasswordValidator 接 口 或 者 从 PasswordValidator 派 生 
人 码 验证 子 类 











改变 账户 验证 
策略 

















在 Startup 类 中 设置 用 户 配置 代码 清单 28-23 





代码 清单 28-24 
实现 IUserValidator 接 口 或 者 从 UserValidator 派 生子 类 一 代码 清单 28- 
26 





实现 自 定义 账 
户 验证 














代码 清单 28-27 
调用 UserManager.DeleteAsync 方 法 和 代码 清单 28- 
28 





























代码 清单 28-29 
调用 UserManager.UpdateAsync 方 法 一 代码 清单 28- 
31 





























28.1 准备 示例 项 目 


在 本 章 中 ， 使 用 ASP.NET Core Web 
Application (.NET Core) 模 板 创 建新 的 名 为 Users 的 
Empty 项 目 。 这 个 示例 应 用 需要 Entity Framework 
Core 命 令 行 工 具 ， 但 该 工具 必须 通过 手动 编 
辑 .csproj 文 件 来 加 入 项 目 。 在 Solution Explorer 窗 格 
中 右 击 Users 项 目 ， 从 弹出 的 采 单 中 选择 Edit 
Users.csproj 文 件 ， 并 添加 代码 清单 28-1 所 示 的 元 
Re 





代码 清单 28-1 在 Users 文 件 夹 下 的 Users.csproj 文 件 中 添加 包 





<Project Sdk="Microsoft.NET.Sdk.Web"> 


<PropertyGroup> 
<TargetFramework>netcoreapp2.0</TargetFramework> 
</PropertyGroup> 


<ItemGroup> 
<Folder Include="wwwroot\" /> 
</ItemGroup> 


<ItemGroup> 
<PackageReference Include="Microsoft.AspNetCore.All 
" Version="2.0.0" /> 
<DotNetCliToolReference Include="Microsoft.EntityFr 
ameworkCore.Tools .DotNet" 


Version="2.0.0" /> 
</ItemGroup> 


</Project> 





代码 清单 28-2 展 示 了 Startup 类 ， 在 其 中 配置 
MVC 框 架 并 启用 开发 中 要 用 到 的 中 间 件 。 





代码 清单 28-2 Users 文 件 夹 下 的 Startup.cs 文 件 的 内 容 


using Microsoft.AspNetCore. Builder; 
using Microsoft.Extensions.DependencyInjection; 


namespace Users { 
public class Startup { 
public void ConfigureServices(IServiceCollectio 


n services) { 
services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app) { 


app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 





创建 控制 蔡 和 视 图 


创建 Controllers 文 件 严 ， 添 加 名 为 
HomeController.cs 的 类 文件 ， 定 义 代码 清单 28-3 所 
示 的 控制 器。 后 面 将 使 用 Home 控 制 右 来 详尽 描述 
用 户 账户 和 数据 ， 操 作 方 法 Index 通 过 View 方 法 传 
递 了 一 个 字典 给 默认 视图 。 


代码 清单 28-3 ”Controllers 文 件 夹 下 的 HomeController.cs 文 件 的 
内 容 


using System.Collections.Generic; 
using Microsoft.AspNetCore.Mvc; 


namespace Users.Controllers { 


public class HomeController : Controller { 


public ViewResult Index() => 
View(new Dictionary<string, object> 
{["Placeholder"] = "Placeholder" }); 





为 了 给 控制 器 提供 视图 ， 创 建 Views/Home 文 


件 夹 ， 添 加 名 为 Index.cshtml 的 视图 文件 ， 内 容 如 代 
码 清 单 28-4 所 示 。 


代码 清单 28-4 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 的 内 


mL 


4S 


@model Dictionary<string, object> 


<div class="bg-primary m-1 p-1 text-white"><h4>User Det 
ails</h4></div> 


<table class="table table-sm table-bordered m-1 p-1"> 
@foreach (var kvp in Model) { 
<tr><tho@kvp.Key</th><td>@kvp.Value</td></tr> 


} 
</table> 





Index 视 图 使 用 表格 来 显示 模型 字典 的 内 容 。 
ASCE, Gl EViews/Shared CF, WIEN 
_Layout.cshtml 的 视图 文件 ， 内 容 如 代码 清单 28-5 所 
示 。 





代码 清单 28-5 Views/Shared 文 件 严 下 的 _Layout.cshtml 文 件 的 
内 容 


<!DOCTYPE html> 
<html> 
<head> 
<title>Users</title> 
<meta name="viewport" content="width=device-width" 


/> 
<link href="/lib/bootstrap/dist/css/bootstrap.css" 
rel="stylesheet" /> 
</head> 
<body class="m-1 p-1"> 
@RenderBody() 
</body> 
</html> 





这 个 视图 基于 Bootstrap CSS 包 来 修饰 HTML 元 
素 。 为 了 将 Bootstrap 包 添加 到 项 目 中 ， 可 使 用 
Bower Configuration File 模 板 创建 bower.json 文 件 ， 
然后 在 dependencies 部 分 添加 Bootstrap 包 ， 如 代码 清 
单 28-6 所 示 。 


代码 清单 28-6 在 Users 文 件 夹 下 的 bower.json 文 件 中 添加 
Bootstrap 包 





{ 


"name": "asp.net", 
"private": true, 
"dependencies": { 


"bootstrap": "4.0.0-alpha.6" 
} 





要 做 的 最 后 的 准备 工作 是 在 Views 文 件 夹 中 创 
建 _ViewImports.cshtml 文 件 ， 以 设置 视图 中 使 用 的 
内 置 标签 助手 ， 如 代码 清单 28-7 所 示 。 





代码 清单 28-7 Views 文 件 夹 下 的 _ViewImports.cshtml 文 件 的 内 


IN 


合 
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 


在 Views 文 件 夹 中 添加 名 为 _ViewStart.cshtml 的 
视图 文件 ， 内 容 如 代码 清单 28-8 所 示 ， 用 以 确保 你 
在 代码 清单 28-5 中 创建 的 布局 将 被 用 于 应 用 的 所 有 
AME 





Sis 4428-8 Views 文件 夹 下 的 _ViewStart.cshtml 文 件 的 内 容 


@{ 
Layout = " Layout"; 
} 


执行 示例 应 用 ， 你 将 看 到 图 28-1 所 示 的 输出 。 











D Users x 
Œ | © localhost:54928 wy): 
Placeholder placehol der 
- 作 、 
图 28-1 输出 


28.2 ”设置 ASP.NET Core Identity 


设置 ASP.NET Core Identity 的 过 程 几乎 涉及 应 
用 的 各 个 部 分 ， 并 且 需 要 新 的 模型 类 、 配 置 更 新 、 
控制 器 和 操作 方法 来 文 持 验证 和 授权 操作 。 下 面 将 
介绍 ASP.NET Core Identity 的 基本 配置 以 展示 涉及 
的 不 同步 骤 。 有 多 种 不 同 的 方式 在 应 用 中 使 用 
ASP.NET Core Identity， 本 章 遵循 最 简单 、 最 钊 用 
的 配置 。 








28.2.1 创建 用 户 类 


第 一 步 是 定义 用 来 表示 应 用 中 用 户 的 类 ， 称 为 
HEX. 





用 户 类 派生 目 IdentityUser 类 ， 该 类 定义 在 
Microsoft.AspNetCore.Identity.EntityFrameworkCore 
命名 空间 中 。IdentityUser 类 提供 基本 的 用 户 表示 ， 
可 以 通过 在 派生 关中 添加 属性 来 扩展 ， 详 见 第 30 
章 。 表 28-3 展 示 了 IdentityUser 类 定义 的 属性 














表 28-3 IdentityUser 类 定义 的 属性 
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PasswordHash | 返回 用 户 密码 的 散 列 值 









































可 用 户 的 电话 号 码 


























分 发 生变 化 之 后 ， 返 回 新 的 值 ， 例 如 当 密 码 发 生变 更 2 

















单独 的 属性 此 刻 并 不 重要 ， 重 要 的 是 ， 
IdentityUser 类 可 以 访问 用 户 的 基本 信息 一 一 用 户 
名 、 电 子 邮件 、 电 话 号 码 、 密 码 的 散 列 值 、 成 员 角 
色 以 及 其 他 信息 。 如 果 期 望 保存 用 户 的 额外 信息 ， 
束 必 须 在 从 IdentityUser 类 派生 的 类 中 添加 属性 ， 从 
而 在 应 用 中 用 来 表示 用 户 。 











为 了 在 应 用 中 创建 用 户 ， 创 建 Models 文 件 夹 ， 
FPS INA A AppUser.cs HJ K 3c FOR BH EA pp User 
类 ， 如 代码 清单 28-9 所 示 。 


代码 清单 28-9 ”Models 文 件 夹 下 的 AppUser.cs 文 件 的 内 容 


using Microsoft.AspNetCore.Identity; 


namespace Users.Models { 


public class AppUser : IdentityUser { 
// no additional members are required 
// for basic Identity installation 


} 





这 束 是 此 刻 必须 要 做 的 事 性 ， 第 30 章 在 展示 如 
何 添加 特定 于 应 用 的 用 户 数 据 属 性 时 ， 还 会 讨论 这 


个 类 。 





配置 视图 导入 


虽然 与 设置 ASP.NET Core Identity 没 有 直接 关 
系 ， 但 仍 需 要 在 视图 中 使 用 AppUser 对 象 。 为 了 简 
化 视图 的 创建 ， 可 在 视图 导入 文件 中 添加 
Users.Models 命 名 空间 ， 如 代码 清单 28-10 所 示 。 

















代码 清单 28-10 ”在 Views 文 件 夹 下 的 _ViewImports.cshtml 文 件 
中 添加 命名 空间 


@using Users.Models 
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 


28.2.2 ”创建 数据 库 上 下 文 类 


下 一 步 是 创建 操作 AppUser 类 的 Entity 
Framework Core 数 据 库 上 下 文 类 。 数 据 库 上 下 文 次 
派生 上 自 IdentityDbContext<T>， 这 里 的 工 恩 是 用 户 类 

(示例 项 目 中 的 AppUser 类 ) 。 添 加 名 为 
AppIdentityDbContext.cs 的 类 文件 到 Models 文 件 夹 
中 ， 并 定义 代码 清单 28-11 所 示 的 类 。 


代码 清单 28-11 Models 文 件 夹 下 的 AppIdentityDbContext.cs 文 
件 的 内 容 





using Microsoft.AspNetCore.Identity.EntityFrameworkCore 


2 
using Microsoft.EntityFrameworkCore; 
namespace Users.Models { 


public class AppIdentityDbContext : IdentityDbConte 
xt<AppUser> { 


public AppIdentityDbContext (DbContextOptions<Ap 


pIdentityDbContext> options) 
: base(options) { } 
} 
} 


数据 库 上 下 文 类 可 以 扩展 为 自 定义 数据 库 的 设 
置 和 使 用 方式 ， 但 是 对 于 基本 的 ASP.NET Core 
Identity 应 用 来 说 ， 仅 仅 定 义 这 个 类 即 可 开始 使 用 ， 
并 为 将 来 的 任何 定制 提供 扩展 空间 。 
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Entity Framework Core， 建 议 将 其 视 为 黑 盒 。 一 旦 
基本 的 构件 块 就 绪 ， 融 可 以 将 它们 复制 到 项 目 中 并 
使 用 ， 几 乎 不 需要 修改 它们 。 





28.2.3 配置 数据 库 连 接 串 








ASP.NET Core Identity 的 第 一 个 配置 步骤 是 定 
义 用 于 数据 库 的 数据 库 连 接 串 。 默 认 会 将 数据 库 连 
接 串 放 在 appsettings.json 文 件 中 ， 在 应 用 启动 时 ， 
该 文件 将 由 Startup 类 加 载 并 由 Startup 类 访问 。 使 用 
ASP.NET Configuration File 模 板 在 项 目的 根 目 录 中 
创建 appsettings.json 文 件 ， 并 添加 代码 清单 28-12 所 
示 的 配置 。 





代码 清单 28-12 ” Users 文件 夹 下 的 appsettings.json 文 件 的 内 容 


"Data": { 
"SportStoreIdentity": { 
"ConnectionString": 
"Server=(localdb)\\MSSQLLocalDB;Database=IdentityUser 


s;Trusted_Connection=True; 
MultipleActiveResultSets=true" 
} 
} 





} 


在 数据 库 连 接 串 中 指定 localdb 选 项 ， 从 而 为 开 
发 人 员 提 供 方便 的 数据 库 文 持 。 对 于 数据 库 本 导 ， 
可 指定 名 称 IdentityUsers 。 
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BUT EEP DAE — 4TH, XÆ Visual 
Studio 中 效果 很 好 ， 但 是 对 于 印刷 而 言 ， 受 限于 纸 
张大 小 ， 不 得 不 分 多 行 显示 。 


使 用 数据 库 连 接 串 ， 可 以 更 新 Startup 类 来 读 取 
配置 文件 并 使 配置 可 用 ， 如 代码 清单 28-13 所 示 。 


代码 清单 28-13 ”在 Users 文 件 夹 下 的 Startup.cs 文 件 中 读 取 应 用 


配置 





using Microsoft.AspNetCore. Builder; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.Extensions.Configuration; 

using Microsoft.AspNetCore.Identity; 

using Microsoft.EntityFrameworkCore; 

using Users.Models; 


namespace Users { 
public class Startup { 


public Startup(IConfiguration configuration) => 
Configuration = configuration; 


public IConfiguration Configuration { get; } 


public void ConfigureServices(IServiceCollectio 
n services) { 
services .AddDbContext<AppIdentityDbContext> 
(options => 
options .UseSqlServer ( 
Configuration[ "Data:SportStoreIdent 
ity:ConnectionString"])); 


services.AddIdentity<AppUser, IdentityRole> 
() 


Context>() 


.AddEntityFrameworkStores<AppIdentityDb 
.AddDefaultTokenProviders() ; 


services.AddMvc(); 


public void Configure(IApplicationBuilder app) 


app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseAuthentication() ; 
app.UseMvcWithDefaultRoute() ; 








创建 基本 的 ASP.NET Core Identity 28 fig 22328, 
更 新 。 第 一 组 是 设置 Entity Framework (EF) Core, 
从 而 为 MVC 应 用 提供 数据 访问 服务 。 





services.AddDbContext<AppIdentityDbContext>(options => 


options.UseSqlServer(Configuration["Data:SportStore 
Identity: ConnectionString"])); 





AddDbContext77 1&0 F JiEntity Framework 
Core 所 需 的 服务 ，UseSqlServer 方 法 用 于 设置 使 用 
Microsoft SQL Server 存 储 数据 所 需 的 文 持 。 
AddDbContext 方 法 允许 你 应 用 之 前 创建 的 数据 库 上 








下 文 类 ， 使 用 从 应 用 配置 中 获取 的 数据 库 连 接 串 中 
的 SQL Server 数 据 库 进行 备份 〈 对 于 示例 应 用 ， 这 
意味 着 读 取 appsettings.json 文 件 ) 。 











你 还 需要 设置 ASP.NET Core Identity 服 务 ， 如 
下 所 示 : 


services.AddIdentity<AppUser, IdentityRole>() 
.AddEntityFrameworkStores<AppIdentityDbContext>() 


.AddDefaultTokenProviders() ; 








AddIdentity 方 法 的 类 型 参数 用 来 指定 表示 用 户 
和 角色 的 类 。 以 上 代码 为 用 户 指 定 了 AppUser 类 ， 
为 角色 指定 了 内 置 的 IdentityRole 类 。 使 用 之 前 创建 
的 数据 库 上 上 下文 类 ，AddEntityFrameworkStores 方 法 
指定 了 应 当 使 用 Entity Framework Core 来 存储 和 检 
过 数据 。AddDefaultTokenProviders 方 法 用 于 使 用 默 
认 配 置 来 支持 获取 token， 例 如 修改 口令 。 








对 Startup 类 所 做 的 最 终 J NET Core 
Identity 添 加 到 请 求 处 理 管线 中 ， 这 意味 看 允许 用 户 
凭据 与 基于 Cookie 或 UREL 重 写 的 请 求 相 关联 ， 还 意 
味 看 用 户 账 户 的 详细 内 容 不 会 直接 包含 在 肥 送 给 应 
用 的 HITP 请 求 或 生成 的 响应 中 。 


app.UseAuthentication() ; 


28.2.4 创建 ASP.NET Core Identity 数 据 库 
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fi ASP.NET Core Identity 数 据 的 数据 库 。 打 开 命 令 
行 窗 口 或 PowerShell 窗 口 ， 导 航 到 Users 文 件 夹 〈 包 
含 Startup.cs 类 文件 的 那个 ) ， 然 后 执行 如 下 命令 : 


正如 为 SportsStore 应 用 设置 数据 库 时 说 明 的 那 


样 ，Entity Framework Core 通 过 名 为 迁移 的 特性 管 
理 对 数据 库 模式 所 做 的 更 新 。 当 修改 用 于 生成 架构 
的 模型 类 时 ， 可 以 生成 包含 SQL 命令 的 迁移 文件 来 
更 新 数据 库 。 该 命令 将 创建 为 ASP.NET Core 
Identity 设 置 数据 库 的 迁移 文件 。 


当 执 行 完 这 个 命令 之 后 ， 你 将 在 Solution 
Explorer 窗 格 中 看 到 Migrations 文 件 严 。 检 得 其 中 的 
内 容 ， 你 就 可 以 看 到 用 来 创建 初始 数据 库 的 SQL 命 
令 。 为 了 使 用 这 些 迁 移 文件 来 创建 数据 库 ， 可 运行 


如 下 命令 : 
dotnet ef database update 


完成 这 个 过 程 可 能 需要 一 扣 时 间 ， 一 旦 命令 完 


成 ， 数 据 库 将 被 创建 并 备用 。 








28.3 ”使 用 ASP.NET Core Identity 


现在 ， 基 本 的 设置 已 经 完成 ， 可 以 开始 使 用 
ASP.NET Core Identity 为 示例 应 用 增加 用 户 管理 文 
持 了 。 下 一 步 将 展示 ASP.NET Core Identity API 如 
何 被 用 来 创建 集中 管理 用 户 的 管理 工具 。 








集中 化 的 用 户 管理 工具 在 所 有 应 用 中 都 很 有 
用 ， 甚 至 可 以 允许 用 户 创建 和 管理 目 己 的 账 己 。 总 
有 一 些 客户 需要 批量 创建 账户 ， 比 如 ， 需 要 检 栓 和 
调整 用 户 数据 的 文 持 问题 。 管 理工 具 非 党 有 用 ， 
为 它们 将 很 多 基本 的 用 户 管 理 功能 整合 到 了 少量 的 
类 中 ， 使 之 成 为 演示 ASP.NET Core Identity 基 本 功 
能 的 有 用 示例 。 

















28.3.1 ”列举 用 户 账 户 








本 节 的 起 点 是 列举 数据 库 中 所 有 的 用 户 账 户 ， 
这 可 以 使 你 看 到 稍 后 添加 到 应 用 中 的 代码 的 效果 。 
Controllers 文 件 夹 中 添加 名 为 AdminController.cs 的 


类 文件 ， 并 定义 代码 清单 28-14 所 示 的 控制 器 ， 进 
而 定义 用 户 管 理 功能 。 


代码 清单 28-14 ”Controllers 文 件 夹 下 的 AdminController.cs 文 件 
的 内 容 


using Microsoft.AspNetCore.Identity; 
using Microsoft.AspNetCore.Mvc; 
using Users.Models; 


namespace Users.Controllers { 
public class AdminController : Controller { 
private UserManager<AppUser> userManager; 


public AdminController(UserManager<AppUser> usr 


Mgr) { 
userManager = usrMgr; 


} 


public ViewResult Index() => View(userManager.U 


sers); 
} 
} 





操作 方法 Index 将 枚 举 ASP.NET Core Identity 系 
统管 理 的 用 户 。 当 然 ， 现 在 没有 任何 用 户 ， 但 很 快 
束 会 有 有 。 可 通过 控制 器 类 的 构造 函数 接收 的 


UserManager<AppUser> 对 象 来 访问 用 户 数据 ， 访 对 
象 由 依赖 注入 系统 提供 。 


有 了 UserManager<AppUser> 对 象 ， 便 可 以 开始 
得 询 数据 存储 。Users 属 性 将 返回 用 户 对 象 的 枚 举 值 
一 一 在 应 用 中 就 是 AppUser 实 例 可 以 使 用 LINQ 
进行 查询 和 操控 。 在 操作 方法 中 ， 将 Users 属 性 传递 
给 View 方 法 ， 以 便 我 们 可 以 显示 账户 的 详情 。 为 了 
给 操作 方法 提供 视图 ， 创 建 Views/Admin 文 件 夹 ， 
并 添加 名 为 Index.cshtml 的 视图 文件 ， 应 用 代码 清单 
28-15 所 示 的 标记 内 容 。 











代 人 码 清 单 28-15 ”Views/Admin 文 件 夹 下 的 Index.cshtml 文 件 的 内 


ZJN 





@model IEnumerable<AppUser> 


<div class="bg-primary m-1 p-1 text-white"><h4>User Acc 
ounts</h4></div> 


<table class="table table-sm table-bordered"> 
<tr><th>ID</th><th>Name</th><th>Email</th></tr> 
@if (Model.Count() == @) { 


<tr><td colspan="3" class="text-center">No User 
Accounts</td></tr> 


} else { 
foreach (AppUser user in Model) { 
<tr> 
<td>@user.Id</td> 
<td>@user .UserName</td> 
<td>@user.Email</td> 
</tr> 
} 
} 


</table> 


<a class="btn btn-primary" asp-action="Create">Create</ 
a> 








Index 视 图 包含 一 个 表格 ， 其 中 的 每 一 行 对 应 
一 个 用 户 ， 表 格 的 列 则 包括 唯一 JD、 用 户 名 和 电子 
邮件 地 址 。 如 果 数 据 库 中 没有 用 户 ， 那 么 会 显示 一 
AAA, Wl 28-2 所 示 ， 局 动 应 用 并 访问 /Admin 
就 可 以 看 到 。 
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ID Name Email 








图 28-2 ”显示 用 户 列 表 〈 目 前 是 空 的 ) 


Index 视 图 中 包含 了 按钮 样式 的 Create 销 点 元 
系 ， 目 标 为 Admin 控 制 右 的 Create 方 法 ， 用 来 文 持 
添加 用 户 的 操作 。 


重症 数据库 


可 以 通过 打开 Visual Studio 的 SQL Server 对 象 资 
源 管 理 吉 来 簿 看 创建 的 数据 库 。 如 采 这 是 你 第 一 次 
使 用 SQL Server 对 象 资源 管理 器 ， 那 么 需要 从 Tools 
腕 单 中 选择 Connect to Database 来 告诉 Visual Studio 
要 使 用 的 数据 库 。 对 于 数据 源 ， 选 择 Microsoft SQL 
Server， 使 用 (localdb)vmssqllocaldb 作 为 服务 名 ， 选 
tH Windowsin uE, Æ- Select Or Enter a 
Database Name 字 段 的 下 拉 箭 头 。 几 秒 后 ， 你 将 看 
到 可 用 的 LocalDB 数 据 库 列 表 ， 你 应 该 可 以 选择 











IdentityUsers， 这 是 示例 应 用 的 数据 库 。 单 击 OK 按 
钮 ，SQL Server Object Explorer 窗 口中 会 显示 一 个 
新 的 条 目 。Visual Studio 将 记 住 该 数据 库 ， 因 此 只 


在 SQL Server Object Explorer 窗 口中 ， 选 择 
(localdb)\mssqllocaldb — Databases — IdentityUsers, 
浏览 数据 库 。 你 将 看 到 由 迁移 文件 创建 的 表 ， 名 称 
类 似 于 AspNetUsers 和 AspNetRoles。 一 旦 将 用 户 添 
加 到 数据 库 中 ， 就 可 以 查询 数据 库 以 便 查 看 表 的 内 


D 


合 。 





要 删除 数据 库 ， 可 右 击 SQL Server Object 
Explorer 窗 口中 的 IdentityUsers 项 目 ， 然 后 从 弹出 的 
豆单 中 选择 Delete， 在 数据 库 删 除 对 话 框 中 选择 所 
有 的 选项 ， 然 后 单 击 OK 按钮 删除 。 


要 重 ; 





陡 创 建 数据 库 ， 可 打开 Package Manager 


Console 窗 口 ， 并 运行 如 下 命令 : 
数据 库 将 被 重建 ， 并 在 下 次 局 动 应 用 时 可 用 。 


28.3.2 ”创建 用 户 


要 为 应 用 接收 的 输入 应 用 MVC 模 型 验证 ， 最 
简 蛙 的 方式 是 为 控制 占 文 持 的 每 个 操作 创建 简 蛙 的 
视图 模型 。 添 加 名 为 UserViewModels.cs 的 类 文件 到 
Models 文 件 夹 中 ， 并 用 它 定 义 代 码 清单 28-16 所 示 


的 类 。 











代码 清单 28-16 ”Models 文 件 夹 下 的 UserViewModels.cs 文 件 的 
内 容 


using System.ComponentModel.DataAnnotations; 
namespace Users.Models { 


public class CreateModel { 
[Required | 


public string Name { get; set; } 
[Required | 
public string Email { get; set; } 
[Required] 


public string Password { get; set; } 





定义 的 初始 模型 名 为 CreateModel， 它 定义 了 创 
建 用 户 账户 所 需 的 基本 属性 一 一 用 户 名 、 电 子 邮件 
地 址 和 密码 。 可 使 用 来 自 
System.ComponentModel.DataAnnotations 命 名 空间 
的 Required 特 性 来 表示 定义 在 模型 中 的 3 个 属性 是 必 


需 的 。 











代码 清单 28-17 为 Admin 控 制 器 添加 了 一 对 
Create 操 作 方 法 ， 它 们 可 由 Index 视 图 中 的 链接 定 
位 ， 并 使 用 标准 的 控制 器 模式 对 GET 请 求 向 用 户 呈 
现 视 图 ， 使 用 POST 请 求 处 理 表单 数据 。 








代码 清单 28-17 在 Controllers 文 件 夹 下 的 AdminController.cs 文 
件 中 定义 Create 操 作 方 法 





using Microsoft.AspNetCore.Identity; 
using Microsoft.AspNetCore.Mvc; 
using Users.Models; 

using System. Threading. Tasks; 


namespace Users.Controllers { 


public class AdminController : Controller { 
private UserManager<AppUser> userManager; 


public AdminController(UserManager<AppUser> usr 


Mer) { 
userManager = usrMgr; 


} 


public ViewResult Index() => View(userManager.U 
sers); 


public ViewResult Create() => View(); 


[HttpPost] 
public async Task<IActionResult> Create(CreateM 
odel model) { 
if (ModelState.IsValid) { 
AppUser user = new AppUser { 
UserName = model.Name, 
Email = model.Email 
}; 
IdentityResult result 
= await userManager.CreateAsync(use 
r, model.Password); 


if (result.Succeeded) { 
return RedirectToAction("Index") ; 
} else { 


foreach (IdentityError error in res 
ult.Errors) { 


ModelState.AddModelError("", er 
ror.Description) ; 


} 


} 


return View(model); 





以 上 代码 中 的 Create 操 作 方法 接收 一 个 
CreateModel 参 数 ， 它 将 在 管理 员 提 交 表 单数 据 时 被 
调用 。ModelState.IsValid 属 性 用 于 检查 数据 是 否 包 
含 所 需 的 值 ， 如 末 包 含 ， 则 创建 AppUser 关 的 新 实 
例 并 传递 给 异步 的 UserManager.CreateAsync 方 法 ， 
如 下 所 示 : 











AppUser user = new AppUser { UserName = model.Name, Ema 
il = model.Email }; 

IdentityResult result = await userManager.CreateAsync(u 
ser, model.Password) ; 


CreateAsync 方 法 的 返回 结果 是 一 个 
IdentityResult 对 象 ， 可 通过 表 28-4 所 示 的 属性 来 描 


述 操 作 结 果 。 





表 28-4 ”IdentityResult 类 定义 的 属性 














Succeeded | 如 果 操 作成 功 ， 返 回 tru 


返回 用 于 描述 在 尝试 操作 时 遇 到 的 错误 的 IdentityError 对 象 序列 。IdentityError 类 
提供 了 Description 属 性 来 汇总 问题 


























在 Create 操 作 方 法 中 检查 Succeeded 属 性 ， 以 确 
定 是 售 在 数据 库 中 创建 了 新 的 用 户 。 如 采 Succeeded 
属性 为 nue， 客 户 将 被 重 定 同 到 Index 操 作 以 便 用 户 
列表 显示 出 来 。 














if (result.Succeeded) { 
return RedirectToAction( "Index" ) ; 


} else { 


foreach (IdentityError error in result.Errors) { 
ModelState.AddModelError("", error.Description) 





如 果 Succeeded 属 性 为 false， 那 么 Errors 属 性 提 
供 的 IdentityError 对 象 序列 将 被 枚 举 ，Description 属 
性 将 被 ModelState.AddModelError 方 法 用 来 创建 模 
型 级 验证 错误 ， 如 第 27 草 所 述 。 


为 了 给 新 的 操作 方法 提供 视图 ， 在 
Views 人 Admin 文件 夹 中 创建 名 为 Create.cshtml 的 视图 
文件 ， 并 添加 代码 清单 28-18 所 示 的 标记 内 容 。 


代码 清单 28-18 ”Views/Admin 文 件 夹 下 的 Create.cshtml 文 件 的 


内 容 





@model CreateModel 


<div class="bg-primary m-1 p-1 text-white"><h4>Create U 
ser</h4></div> 


<div asp-validation-summary=" All" class="text-danger"> 


</div> 
<form asp-action="Create" method="post"> 
<div class="form-group"> 
<label asp-for="Name"></label> 
<input asp-for="Name" class="form-control" /> 
</div> 
<div class="form-group"> 
<label asp-for="Email"></label> 
<input asp-for="Email" class="form-control" /> 
</div> 
<div class="form-group"> 
<label asp-for="Password"></label> 
<input asp-for="Password" class="form-control" 
/> 
</div> 
<button type="submit" class="btn btn-primary">Creat 
e</button> 


<a asp-action="Index" class="btn btn-secondary">Can 
cel</a> 
</form> 





Create 视 图 没什么 特别 之 处 ， 只 是 一 个 简单 的 
表单 ， 用 于 收集 MVC 用 来 绑 定 到 模型 类 的 属性 的 
值 ， 模 型 类 的 属性 被 传递 给 Create 操 作 方 法 ， 并 包 
含有 验证 错误 时 的 摘要 。 


测试 创建 功能 





为 了 测试 创建 新 用 户 账 户 的 能 力 ， 局 动 应 用 并 
导航 到 UREL 地 址 /Admin， 然 后 单 击 Create 按 钮 ， 使 
用 表 28-5 提 供 的 值 填写 表单 。 


人 
提示 


人 们 为 测试 保留 了 一 些 域名 ， 如 
example.com。 你 可 以 在 IETF 网 站 上 看 到 完整 列 





表 28-5 创建 示例 用 户 的 值 (一 )》 








输入 值 之 后 ， 单 击 Create 按 钮 ，ASP.NET Core 





Identity 将 会 创建 用 户 账 户 。 当 浏览 器 被 重 定 问 到 

Index 操 作 方 法 之 后 ， 将 显示 创建 的 用 户 账 户 ， 如 图 
28-3 所 示 《 你 将 会 看 到 不 一 样 的 ID， 因 为 每 个 账户 
会 随机 生成 ID) 。 






D Users 
e C |© localhost:54 ji 


wi: 
User Accounts 
ID 


Name Email 






e joe@example.com 


b41dee43-c71c-4a4c-b3fd-872c98f670d8 
= 





图 28-3 ”添加 新 的 用 户 账 户 


再 次 单 击 Create 按 钮 并 在 表单 中 输入 表 28-5 中 
同样 的 值 。 提 交 表 单 后 ， 你 将 看 到 由 模型 验证 摘要 
报告 的 错误 ， 如 图 28-4 所 示 。 











D Uses x 
一 G | © localhost:54 Ad t wl): 
Create User 

e User name ‘Joe’ is already taken 

ame 

Joe 











图 28-4” 因 试图 创建 相同 用 户 账 户 产生 的 错误 
28.3.3 ”验证 密码 


对 于 企业 级 应 用 ， 最 背 见 的 需求 之 一 是 强制 密 
码 人 策略 。 可 以 通过 运行 应 用 来 租 看 默认 的 策略 ， 访 
问 /Admin/Create， 然 后 使 用 表 28-6 所 示 的 数据 填 元 
表单 ， 与 之 前 的 重要 区 别 在 于 Password 字 上 段 。 





表 28-6 ”创建 示例 用 户 的 值 Z) 





Password secret 





当 提 交 表 单 到 服务 器 之 后 ，ASP.NET Core 
Identity 系 统 检查 备 选 的 密码 ， 如 果 不 符合 要 求 ， 将 
生成 错误 消息 ， 生 成 的 错误 消息 如 网 28-5 所 示 。 











二 CS | © locathost:54 t vw): 
Create User 

e Passwords must have at least one non alphanumeric character 

e Passwords must have at least digit 

. ppe 
Nam 

Alic 

màd, 





图 28-5 ”密码 验证 错误 消息 


可 以 在 Startup 类 中 配置 密码 验证 规则 ， 如 代码 
清单 28-19 所 示 。 


代码 清单 28-19 ”在 Users 文 件 夹 下 的 Startup.cs 文 件 中 配置 密码 
验证 规则 





using Microsoft.AspNetCore. Builder; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.Extensions.Configuration; 

using Microsoft.AspNetCore. Identity; 

using Microsoft.EntityFrameworkCore; 


using Users.Models; 
namespace Users { 


public class Startup { 


public Startup(IConfiguration configuration) => 
Configuration = configuration; 


public IConfiguration Configuration { get; } 


public void ConfigureServices(IServiceCollectio 
n services) { 


services .AddDbContext<AppIdentityDbContext> 
(options => 
options.UseSqlServer ( 
Configuration[ "Data:SportStoreIdent 
ity: ConnectionString"])); 


services.AddIdentity<AppUser, IdentityRole> 
(opts => { 
opts.Password.RequiredLength = 6; 
opts.Password.RequireNonAlphanumeric = 
false; 
opts.Password.RequireLowercase = false; 
opts.Password.RequireUppercase = false; 
opts.Password.RequireDigit = false; 
}) .AddEntityFrameworkStores<AppIdentityDbCo 
ntext>() 
.AddDefaultTokenProviders() ; 


services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app) 


app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseAuthentication() ; 
app.UseMvcWithDefaultRoute() ; 





AddIdentity 方 法 可 以 与 一 个 接收 IdentityOptions 
对 象 的 疯 数 一 起 使 用 ， 该 函数 的 Password 属 性 将 返 
回 一 个 PasswordOptions 实 例 ，PasswordOptions 类 所 


供 了 如 表 28-7 所 示 的 用 于 管理 密码 脓 略 的 属性 。 





4228-7 PasswordOptions 类 定义 的 属性 


RequiredLength 于 指定 密码 的 最 小 长 度 








RequireNonAlphanumeric 为 true 时 要 求 密码 至 少 包 含 一 个 非 字 符 或 数字 的 字符 


RequireUppercase 为 true 时 要 求 密码 至 少 包含 一 个 大 写字 母 





RequireDigit 为 true 时 要 求 密码 至 少 包 含 一 个 数字 








启动 应 用 ， 导 航 到 /Admin/Create， 然 后 重新 提 
区 表单 ， 你 将 看 到 密码 secret 被 接受 ， 并 为 Alice 创 
建 了 一 个 新 的 账户 ， 如 图 28-6 所 示 。 





€ © | © localhost:54928/Ad: 人 女 | : 
User Accounts 

ID Name Email 
3c0aSb0a-d2a5-4ef2-8514-S89b6fc2f45d Alice alice@example.com 
b41dee43-c71c-4a4c-b3fd-872c98f670d8 Joe joe@example.com 








图 28-6 ”改变 密码 验证 策略 





实现 目 定 义 的 密友 验证 全 上 略 





内 置 的 密码 验证 策略 对 于 大 多 数 应 用 是 足够 
的 ， 但 是 你 可 能 需要 实现 目 定义 的 密码 验证 策略 ， 
特别 是 当 你 正在 为 企业 级 在 线 业 务 应 用 实施 常见 的 
复 林 和 客人 码 验 证 案 略 时 。 密 人 码 验 证 功能 
Microsoft.AspNetCore.Identity 命 名 空间 的 











IPasswordValidator<T> 接 口 定 义 ， 这 里 的 T 是 应 用 
特定 的 用 户 类 【在 示例 中 是 AppUser) 。 


using System.Threading.Tasks; 
namespace Microsoft.AspNetCore.Identity { 


public interface IPasswordValidator<TUser> where TU 
ser : class { 


Task<IdentityResult> ValidateAsync(UserManager< 
TUser> manager， 
TUser user, string password); 


} 





ValidateAsync 方 法 和 被 调用 以 验证 密码 ， 
UserManager 对 象 提供 了 数据 上 下 文 〈 人 允许 得 询 
ASP.NET Core Identity 数 据 库 ) ， 访 对象 表示 用 户 
和 候选 密码 。 返 回 的 结果 是 一 个 IdentityResult 对 
象 ， 如 果 验 证 没有 问题 ， 则 使 用 静态 的 Success 属 性 
创建 这 个 对 象 ;， 人 否则， 使 用 静态 的 Failed 方 法 ， 该 
方法 会 传递 一 个 IdentityError 数 组 对 象 ， 其 中 的 每 个 
对 象 描述 一 个 验证 问题 。 





为 了 演示 目 定 义 的 密码 验证 策略 ， 创 建 
Infrastructure LFX, WI AN 
CustomPasswordValidator.cs 的 类 文件 ， 并 定义 代码 
清单 28-20 所 示 的 类 。 


代码 清单 28-20 Infrastructure CEE FAY 
CustomPasswordValidator.cs 文 件 的 内 容 





using System.Collections.Generic; 
using System.Threading.TasKs ; 

using Microsoft.AspNetCore.Identity; 
using Users.Models; 


namespace Users.Infrastructure { 


public class CustomPasswordValidator : IPasswordVal 
idator<AppUser> { 


public Task<IdentityResult> ValidateAsync(UserM 
anager<AppUser> manager, 
AppUser user, string password) { 


List<IdentityError> errors = new List<Ident 
ityError>(); 


if (password. ToLower().Contains(user.UserNa 
me.ToLower())) { 
errors.Add(new IdentityError { 
Code = "PasswordContainsUserName" , 


Description = "Password cannot cont 
ain username" 
})3 
} 
if (password.Contains("12345")) { 
errors.Add(new IdentityError { 
Code = "PasswordContainsSequence", 
Description = "Password cannot cont 
ain numeric sequence" 
})3 
} 


return Task.FromResult(errors.Count == @ ? 
IdentityResult.Success : IdentityResult 
.Failed(errors.ToArray())); 


} 


} 





验证 器 类 检查 密码 并 确保 不 包含 用 户 名 和 序列 
12345。 代 码 清单 28-21 为 AppUser 对 象 注 册 了 
CustomPasswordValidator 类 作为 密码 验证 器 。 


代码 清单 28-21 ”在 Startup.cs 文 件 中 注册 目 定 义 的 密码 验证 器 





using Microsoft.AspNetCore. Builder; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.Extensions.Configuration; 

using Microsoft.AspNetCore.Identity; 

using Microsoft.EntityFrameworkCore; 

using Users.Models; 


using Users.Infrastructure; 
namespace Users { 
public class Startup { 


public Startup(IConfiguration configuration) => 
Configuration = configuration; 


public IConfiguration Configuration { get; } 


public void ConfigureServices(IServiceCollectio 
n services) { 


services.AddTransient<IPasswordValidator<Ap 
pUser>, 
CustomPasswordValidator>(); 


services .AddDbContext<AppIdentityDbContext> 
(options => 
options.UseSqlServer ( 
Configuration[ "Data:SportStoreIdent 
ity:ConnectionString"])); 


services.AddIdentity<AppUser, IdentityRole> 


(opts => { 
opts.Password.RequiredLength = 6; 
opts.Password.RequireNonAlphanumeric = 
false; 
opts.Password.RequireLowercase = false; 
opts.Password.RequireUppercase = false; 
opts.Password.RequireDigit = false; 
}) .AddEntityFrameworkStores<AppIdentityDbCo 
ntext>() 


.AddDefaultTokenProviders(); 


services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app) 


app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseAuthentication(); 
app.UseMvcWithDefaultRoute(); 





为 了 测试 自 定 义 的 密码 验证 策略 ， 启 动 应 用 并 
访问 /Admin/Create， 使 用 表 28-8 所 示 的 数据 填充 表 
FA 





4228-8 创建 示例 用 户 的 值 〈 三 ) 


























表 28-8 中 的 密 人 码 违反 了 两 个 验证 规则 ， 因 而 返 
回 图 28-7 所 示 的 错误 消息 。 








图 28-7 (EH K EX MAIE AS 





EPJ PASE BRAY A Ser uk ae SE ite AE MY 
FUE Bo BRU Sark a NE MCE 
Microsoft.AspNetCore.Identity 命 名 空间 中 的 
PasswordValidator。 代 码 清单 28-22 将 自 定义 的 验证 
器 修改 为 派生 自 PasswordValidator 类 ， 并 基于 提供 
的 基本 检 醋 来 实现 验证 。 





代码 清单 28-22 ”在 CustomPasswordValidator.cs 文 件 中 从 内 置 的 
验证 器 派生 自 定 义 的 验证 器 


using System.Collections.Generic; 


using System.Threading.TasKs ; 

using Microsoft.AspNetCore.Identity ; 
using Users.Models; 

using System.Ling; 


namespace Users.Infrastructure { 


public class CustomPasswordValidator : PasswordVali 
dator<AppUser> { 
public override async Task<IdentityResult> Vali 
dateAsync( 
UserManager<AppUser> manager, AppUs 
er user, string password) { 


IdentityResult result = await base.Validate 
Async(manager, 
user, password); 


List<IdentityError> errors = result.Succeed 
ed ? 
new List<IdentityError>() : result.Erro 
rs.ToList(); 


if (password. ToLower().Contains(user.UserNa 
me.ToLower())) { 
errors.Add(new IdentityError { 
Code = "PasswordContainsUserName" , 
Description = "Password cannot cont 
ain username" 


}); 
} 


if (password.Contains("12345")) { 
errors.Add(new IdentityError { 
Code = "PasswordContainsSequence", 
Description = "Password cannot cont 
ain numeric sequence" 


})s 
} 


return errors.Count == © ? IdentityResult.S 


: IdentityResult.Failed(errors. ToArray( 





为 了 测试 组 合 验证 ， 可 运行 应 用 并 
在 /Admin/Create 返 回 的 表单 中 使 用 表 28-9 所 示 的 数 
据 填 充 表 单 。 





表 28-9 创建 示例 用 户 的 值 〈 四 ) 




















提交 表单 后 ， 你 将 看 到 组 合 了 上 自 定 义 验证 和 内 








置 验证 的 错误 消 虫 ， 如 图 28-8 所 示 。 


Du 





ses x 
€ S | © localhost:54 


i t j| E 
Create User 
e Passwords must be at least 6 characters. 
e Password cannot contain numeric sequence 
e 





图 28-8 组 合 目 定 义 验 证 和 内 置 验证 
28.3.4 ”验证 用 户 详 情 


在 创建 账户 的 时 候 ， 验 证 也 同样 作用 于 用 户 名 

和 电子 邮件 地 址 。 为 了 查看 内 置 验证 ， 局 动 应 用 并 
使 用 表 28-10 所 示 的 数据 填充 地 址 /Admin/Create 返 回 
的 表单 。 


表 28-10 ”创建 示例 用 户 的 值 (五 》 








Email alice@example.com 


Password secret 





提交 表单 后 ， 你 将 看 到 图 28-9 所 示 的 验证 错误 
消息 。 





[M Users x 
€ C | O localhost:54 Ad aat ra o 
Create User 
e User name ‘Bob!’ is invalid, can only contain letters or digits 
Nam 
Bob 
Email 
a ee e ppp r ee a o dt 








图 28-9 ”验证 错误 消息 


验证 可 以 在 Startup 类 中 使 用 
IdentityOptions.User 属 性 进行 配置 ， 该 属性 将 返回 
UserOptions 类 的 实例 ， 表 28-11 接 述 了 UserOptions 
类 定义 的 属性 


表 28-11 UserOptions 类 定义 的 属性 











包含 可 以 用 于 用 户 名 的 所 有 字符 ， 默 认 值 为 a 一 z、A 一 2 和 0 
一 9 以 及 连 字符 C). IAO, FHR C 和 @。 这 个 属 
性 不 是 正则 表达 式 ， 并 且 任 何 合法 字符 必须 显 式 包含 在 这 个 














AllowedUserNameCharacters 

















字符 串 中 


Jue RN HLA 


代码 清单 28-23 修 改 了 应 用 的 配置 以 便 要 求 唯 
一 的 电子 邮件 地 址 ， 以 及 仅 有 小 写字 母 可 用 于 用 户 
名 。 


















































代码 清单 28-23 在 Startup.cs 文 件 中 修改 用 户 账 户 的 设置 





using Microsoft.AspNetCore. Builder; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.Extensions.Configuration; 

using Microsoft.AspNetCore.Identity; 

using Microsoft.EntityFrameworkCore; 

using Users.Models; 

using Users.Infrastructure; 


namespace Users { 
public class Startup { 


public Startup(IConfiguration configuration) => 
Configuration = configuration; 


public IConfiguration Configuration { get; } 


public void ConfigureServices(IServiceCollectio 
n services) { 


services .AddTransient<IPasswordValidator<Ap 
pUser>, 
CustomPasswordValidator>(); 


services .AddDbContext<AppIdentityDbContext> 
(options => 
options.UseSqlServer ( 
Configuration[ "Data:SportStoreIdent 
ity:ConnectionString"])); 


services.AddIdentity<AppUser, IdentityRole> 
(opts => { 
opts.User.RequireUniqueEmail = true; 
opts.User.AllowedUserNameCharacters = "ab 
cdefghijklmnopqrstuvwxyz”" ; 
opts.Password.RequiredLength = 6; 
opts.Password.RequireNonAlphanumeric = 


false; 
opts.Password.RequireLowercase = false; 
opts.Password.RequireUppercase = false; 
opts.Password.RequireDigit = false; 
}) .AddEntityFrameworkStores<AppIdentityDbCo 
ntext>() 
.AddDefaultTokenProviders(); 
services.AddMvc(); 
} 
public void Configure(IApplicationBuilder app) 
{ 


app.UseStatusCodePages(); 


app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseAuthentication() ; 
app.UseMvcWithDefaultRoute() ; 





重新 提交 测试 的 上 一 个 表单 ， 你 将 会 看 到 电子 
邮件 地 址 导致 新 的 错误 ， 而 且 用 于 用 户 名 的 字符 仍 
然 被 拒绝 ， 如 图 28-10 所 示 。 














< C |O localhost:54 jmin/Creat wl: 


e User name ‘Bob!’ is invalid, can only contain letters or digits. 
e Email ‘alice@example.com’ is already taken 


Name 


Bobl 


Email 


alice@example com 


Pap a JP paa pun D G 





图 28-10 ”修改 账户 验证 设置 
实现 目 定 义 用 户 验 证 


验证 功能 由 接口 IUserValidator<T> 定 义 ， 它 定 


义 在 命名 空间 Microsoft.AspNetCore.Identity 中 。 





using System.Threading.TasKs ; 


namespace Microsoft.AspNetCore.Identity { 


public interface IUserValidator<TUser> where TUser 
: class { 
Task<IdentityResult> ValidateAsync(UserManager< 
TUser> manager, TUser user); 
} 
} 





ValidateAsync 方 法 被 调用 以 执行 验证 。 返 回 结 
果 是 一 个 ldentityResult 对 象 ， 与 验证 密码 的 类 相 
同 。 为 了 演示 上 自 定义 验证 ， 在 Infrastructure 文 件 夹 
中 添加 名 为 CustomUserValidator.cs 的 类 文件 ， 并 用 
它 定义 代码 清单 28-24 所 示 的 类 。 


代码 清单 28-24 ”Infrastructure 文 件 夹 下 的 
CustomUserValidator.cs 文 件 的 内 容 





using System.Threading.Tasks; 
using Microsoft.AspNetCore.Identity ; 
using Users.Models; 


namespace Users.Infrastructure { 


public class CustomUserValidator : IUserValidator<A 
ppUser> { 


public Task<IdentityResult> ValidateAsync(UserM 
anager<AppUser> manager, 
AppUser user) { 


if (user.Email.ToLower().EndswWith("@example 
.com")) { 
return Task. FromResult(IdentityResult.S 
uccess); 
} else { 
return Task.FromResult(IdentityResult.F 
ailed(new IdentityError { 


Code = "EmailDomainError", 
Description = "Only example.com ema 
il addresses are allowed" 
})); 





上 述 验证 器 检查 电子 邮件 的 域 以 确认 是 
example.com 域 的 一 部 分 ， 代 码 清单 28-25 对 这 个 目 
定义 类 【作为 AppUser 对 象 的 验证 器， 进行 了 注 
册 。 


代码 清单 28-25 ”在 Startup.cs 文 件 中 注册 目 定 义 的 用 户 验 证 器 


public void ConfigureServices(IServiceCollection servic 


es) { 


services.AddTransient<IPasswordValidator<AppUser>, 
CustomPasswordValidator>(); 

services .AddTransient<IUserValidator<AppUser>, 
CustomUserValidator>(); 


services .AddDbContext<AppIdentityDbContext> (options 
=> 
options.UseSqlServer ( 
Configuration[ "Data:SportStoreIdentity:Conn 
ectionString"])); 


services.AddIdentity<AppUser, IdentityRole>(opts => 


opts.User.RequireUniqueEmail = true; 
opts.User.AllowedUserNameCharacters = "abcdefgh 
ijklmnopqrstuvwxyz" ; 

opts.Password.RequiredLength = 6; 
opts.Password.RequireNonAlphanumeric = false; 
opts.Password.RequireLowercase = false; 
opts.Password.RequireUppercase = false; 
opts.Password.RequireDigit = false; 

}) .AddEntityFrameworkStores<AppIdentityDbContext>() 
.AddDefaultTokenProviders() ; 


services.AddMvc(); 





为 了 测试 目 定 义 验 证 嚣 ， 运 行 应 用 并 使 用 表 
28-12 所 示 的 数据 填充 地 址 /Admin/Create 返 回 的 表 
单 。 


表 28-12 创建 示例 用 户 的 值 (六 ) 




















用 户 名 和 密码 己 通 过 验证 ， 但 电子 邮件 地 址 不 
是 正确 的 域 。 所 有 交 表 和 蛙 后 ， 你 将 看 到 图 28-11 所 示 
的 错误 消 居 。 











[D Users 
一 C | © localhost54928/Adm eat wr) : 


Create User 
e Only example.com ema llowed 





图 28-11 错误 消息 
将 UserValidator<T> 类 提供 的 内 置 验证 与 日 定 


义 验证 相 结 合 的 处 理 过 程 与 验证 密码 遵循 相同 的 模 
式 ， 如 代码 清单 28-26 所 示 。 





代码 清单 28-26 在 CustomUserValidator.cs 文 件 中 扩展 内 置 的 
用 户 验 证 





using System.Collections.Generic; 
using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Identity; 
using Users.Models; 


namespace Users.Infrastructure { 


public class CustomUserValidator : UserValidator<Ap 
pUser> { 


public override async Task<IdentityResult> Vali 
dateAsync( 
UserManager<AppUser> manager, 
AppUser user) { 


IdentityResult result = await base.Validate 
Async(manager, user); 


List<IdentityError> errors = result.Succeed 


ed ? 
new List<IdentityError>() : result.Erro 
rs.ToList(); 


if (!user.Email.ToLower().Endswith("@exampl 
e.com")) { 
errors.Add(new IdentityError { 


Code = "EmailDomainError", 
Description = "Only example.com ema 
il addresses are allowed" 
})3 
} 
return errors.Count == © ? IdentityResult.S 


: IdentityResult.Failed(errors. ToArray( 





28.4 完成 管理 功能 


只 需要 实现 编辑 和 删除 用 户 的 功能 即 可 完成 管 
理工 具 。 在 代码 清单 28-27 中 ， 可 以 看 到 对 
Views/Admin/Index. cshtml 文 件 所 做 的 修改 ， 以 便 
在 管理 控制 台中 人 处 理 Edit 和 Delete 操 作 。 





代码 清单 28-27 在 Views/Admin 文 件 夹 下 的 Index.cshtml 文 件 中 
添加 Edit 和 Delete 按 钮 





@model IEnumerable<AppUser> 


<div class="bg-primary m-1 p-1 text-white"><h4>User Acc 
ounts</h4></div> 


<div class="text-danger" asp-validation-summary="Model0O 
nly"></div> 


<table class="table table-sm table-bordered"> 
<tr><th>ID</th><th>Name</th><th>Email</th></tr> 
@if (Model.Count() == @) { 
<tr><td colspan="3" class="text-center">No User 
Accounts</td></tr> 
} else { 
foreach (AppUser user in Model) { 
<tr> 
<td>@user.Id</td><td>@user.UserName</td 
><td>@user.Email</td> 
<td> 
<form asp-action="Delete" asp-route 
-id="@user.Id" method="post"> 
<a class="btn btn-sm btn-primar 
y" asp-action="Edit" 
asp-route-id="@user.Id">Edi 
t</a> 
<button type="submit" 
class="btn btn-sm btn-danger 
">Delete</button> 
</form> 
</td> 
</tr> 


} 


</table> 
<a class="btn btn-primary" asp-action="Create">Create</ 
a> 
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操作 方法 ， 这 很 重要 ， 因 为 修改 应 用 状态 需要 
POST 请 求 。Edit 按 钮 是 锚 点 元 素 ， 用 于 发 送 GET 请 
求 ， 因 为 编辑 过 程 的 第 一 步 是 显示 当前 的 数据 。 
Edit 按 钮 包含 在 表单 元 素 内 以 便 Bootstrap CSS 样 式 
不 会 将 其 垂直 堆 羞 起来。 加 入 模型 验证 的 摘要 信息 
到 视图 中 ， 以 便 可 以 轻松 地 显示 由 其 他 管理 功能 导 
致 的 错误 消息 。 














28.4.1 ”实现 删除 功能 


UserManager<T> 类 定义 了 DeleteAsync 方 法 ， 
该 方法 接收 AppUser 类 的 实例 ， 并 将 其 从 数据 库 中 
删除 。 在 代码 清单 28-28 中 ， 可 以 看 到 如 何 使 用 
DeleteAsync 方 法 在 Admin 控 制 器 中 实现 删除 功能 。 


代码 清单 28-28 ”在 Controllers 文 件 夹 下 的 AdminController.cs 文 
件 中 有 删除 用 户 





using Microsoft.AspNetCore.Identity; 
using Microsoft.AspNetCore.Mvc; 
using Users.Models; 

using System. Threading. Tasks; 


namespace Users.Controllers { 


public class AdminController : Controller { 
private UserManager<AppUser> userManager; 


public AdminController(UserManager<AppUser> usr 


Mer) { 
userManager = usrMgr; 
} 
// ...other actions omitted for brevity... 
[HttpPost ] 
public async Task<IActionResult> Delete(string 
id) { 
AppUser user = await userManager.FindByIdAs 
ync(id); 


if (user != null) { 
IdentityResult result = await userManag 
er.DeleteAsync(user) ; 
if (result.Succeeded) { 
return RedirectToAction("Index") ; 
} else { 
AddErrorsFromResult(result) ; 


} 
} else { 


ModelState.AddModelError("", "User Not 
Found"); 


return View("Index", userManager.Users) ; 


} 


private void AddErrorsFromResult(IdentityResult 
result) { 


foreach (IdentityError error in result.Erro 
rs) { 
ModelState.AddModelError("", error.Desc 


ription); 





操作 方法 接收 用 户 的 唯一 ID 作为 参数 ， 并 使 用 
FindByIdAsync 方 法 找到 相应 的 user 对 象 ， 以 便 可 以 
传递 给 DeleteAsync 方 法 。DeleteAsync 方 法 的 返回 
结果 是 一 个 IdentityResult 对 象 。 使 用 前 面 同样 的 方 
式 进 行 处 理 ， 以 确保 癌 用 户 显示 任何 错误 。 可 以 通 
过 创建 用 户 ， 然 后 单 击 Index 视 图 中 的 Delete 按 钮 来 
测试 删除 功能 ， 如 图 28-12 所 示 。 











3c0a5b0a-d2a5-4ef2-8514-589b6fc2f45d Alice alice@example.com fm 


-4845-492c-9ebe-836aa50fcbf9 test test@example.co 
41 dee43-c71¢-4a4e 
dee43-c71¢-4a4c-b3fd-872c98f670d8 Joe  joe@example.com 











图 28-12 删除 用 户 账 户 
28.4.2 ”实现 编辑 功能 


要 完成 管理 工具 ， 需 要 加 入 对 用 户 账 户 的 电子 
邮件 地 址 和 密码 的 编辑 支持 。 此 刻 ， 它 们 是 用 户 定 
义 的 仅 有 的 两 个 属性 ， 第 30 章 将 介绍 如 何 使 用 自 定 
义 属 性 来 扩展 架构 。 代 码 清单 28-29 展 示 了 添加 到 
Admin 控 制 器 的 Edit 操 作 方 法 。 


代码 清单 28-29 ”为 Controllers 文 件 夹 下 的 AdminController.cs 文 
件 中 实现 编辑 功能 





using Microsoft.AspNetCore.Identity; 
using Microsoft.AspNetCore.Mvc; 
using Users.Models; 

using System. Threading.Tasks; 


namespace Users.Controllers { 


public class AdminController : Controller { 
private UserManager<AppUser> userManager ; 
private IUserValidator<AppUser> userValidator; 
private IPasswordValidator<AppUser> passwordValid 
ator; 
private IPasswordHasher<AppUser> passwordHasher ; 


public AdminController(UserManager<AppUser> usrMg 
r, 

IUserValidator<AppUser> userValid, 
IPasswordValidator<AppUser> passValid, 
IPasswordHasher<AppUser> passwordHash) { 

userManager = usrMgr; 

userValidator = userValid; 

passwordValidator = passValid; 

passwordHasher = passwordHash; 


} 


// ...other action methods omitted for brevity. 


public async Task<IActionResult> Edit(string id 
) { 
AppUser user = await userManager .FindByIdAs 
ync(id); 
if (user != null) { 
return View(user); 
} else { 
return RedirectToAction("Index") ; 
} 
} 


[HttpPost ] 
public async Task<IActionResult> Edit(string id 


， string email, 
string password) { 
AppUser user = await userManager.FindByIdAs 
ync(id); 
if (user != null) { 
user.Email = email; 
IdentityResult validEmail 
= await userValidator.ValidateAsync 
(userManager, user); 
if (!validEmail.Succeeded) { 
AddErrorsFromResult(validEmail) ; 
} 
IdentityResult validPass = null; 
if (!string.IsNullOrEmpty(password)) { 
validPass = await passwordValidator 
. ValidateAsync(userManager, 
user, password) ; 
if (validPass.Succeeded) { 
user.PasswordHash = passwordHas 
her .HashPassword(user, 
password) ; 
} else { 
AddErrorsFromResult(validPass) ; 
} 
} 
if ((validEmail.Succeeded && validPass 
== null) 
|| (validEmail.Succeeded 
&& password != string.Empty && 
validPass.Succeeded)) { 
IdentityResult result = await userM 
anager .UpdateAsync(user) ; 
if (result.Succeeded) { 
return RedirectToAction( "Index" 
) 
} else { 


AddErrorsFromResult(result) ; 
} 


} 
} else { 
ModelState.AddModelError("", "User Not 
Found"); 


return View(user) ; 


} 
private void AddErrorsFromResult(IdentityResult 
result) { 


foreach (IdentityError error in result.Erro 


rs) { 
ModelState.AddModelError("", error.Desc 


ription); 
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GET 请 求 来 调用 FindByIdAsync 方 法 以 获取 表示 用 
户 的 AppUser 对 象 。 


更 复杂 的 实现 则 接收 POST 请 求 ， 其 中 带 有 用 
户 ID、 新 的 电子 邮件 地 址 和 密码 。 必 须 执 行 几 个 任 
务 才能 完成 Edit 操 作 。 


第 一 个 任务 是 验证 接收 的 值 。 此 刻 ， 正 在 使 用 
简单 的 user 对 象 ， 尽 管 第 30 章 将 展示 如 何 自 定义 为 
用 户 存储 的 数据 。 即 便 如 此 ， 也 仍然 需要 验证 数据 
以 确保 不 会 违反 28.3.3 节 和 28.3.4 节 中 的 自 定 义 验 证 
党 略 。 要 验证 电子 邮件 地 址 ， 可 以 这 样 做 : 








user.Email = email; 

IdentityResult validEmail = await userValidator.Validat 

eAsync(userManager, user); 

if (!validEmail.Succeeded) { 
AddErrorsFromResult(validEmail) ; 


} 





为 IUserValidator<AppUser> 在 控制 占 的 构造 函 
数 中 添加 依赖 ， 以 便 可 以 验证 新 的 电子 邮件 地 址 。 
注意 ， 在 验证 之 前 ， 必 须 修改 Email 属 性 ， 因 为 
ValidateAsync 方 法 仅仅 接收 user 对 象 。 


下 一 步 是 更 改 密码 〈 如 果 已 经 提供 ) 。 
ASP.NET Core Identity 存 储 密码 的 哈 希 值 而 不 是 密 








码 本 号 ， 这 是 为 了 防止 密码 被 资 。 接 下 来 获取 通过 
验证 的 密码 并 生成 将 存储 到 数据 库 中 的 aaa » IX 
将 在 第 29 章 中 演示 。 密 码 通过 实现 了 
ee 口 的 类 被 转换 为 哈欠 
值 ， 可 通过 声明 依赖 注入 的 构造 函数 参数 来 获取 。 
ee 口 定 义 了 HashPassword 方 法 ， 访 
方法 接收 一 个 字符 串 参 数 并 返回 对 应 的 哈 希 值 ， 如 
下 所 示 : 


if (!string.IsNullOrEmpty(password)) { 

validPass = await passwordValidator.ValidateAsync(u 
serManager, user, password); 

if (validPass.Succeeded) { 


user.PasswordHash = passwordHasher.HashPassword 
(user, password); 
} else { 
AddErrorsFromResult(validPass) ; 


} 





对 AppUser 类 的 所 做 修改 不 会 被 存储 ， 直 到 
UpdateAsync 方 法 被 调用 ， 如 下 上 所 示 : 


if ((validEmail.Succeeded && validPass == null) || (val 
idEmail.Succeeded 

&& password != string.Empty && validPass.Succee 
ded)) { 


IdentityResult result = await userManager.UpdateAsy 
nc(user) ; 


if (result.Succeeded) { 
return RedirectToAction("Index") ; 
} else { 


AddErrorsFromResult(result) ; 


} 





创建 视图 








最 后 的 组 件 是 用 来 回 用 户 显 示 当 前 值 并 允许 将 
新 值 提 交 给 控制 辟 的 视图 ， 人 代码 清 单 28-30 展 示 了 
创建 在 Views/Admin 文 件 夹 下 的 Edit.cshtml 文 件 中 的 
内 容 。 





代码 清单 28-30 ”Views/Admin 文 件 夹 下 的 Edit.cshtml 文 件 的 内 


IP 


谷 


@model AppUser 


<div class="bg-primary m-1 p-1"><h4>Edit User</h4></div 
> 


<div asp-validation-summary="All" class="text-danger">< 
/div> 


<form asp-action="Edit" method="post"> 
<div class="form-group"> 
<label asp-for="Id"></label> 
<input asp-for="Id" class="form-control" disabl 
ed /> 
</div> 
<div class="form-group"> 
<label asp-for="Email"></label> 
<input asp-for="Email" class="form-control" /> 
</div> 
<div class="form-group"> 
<label for="password">Password</label> 
<input name="password" class="form-control" /> 
</div> 
<button type="submit" class="btn btn-primary">Save< 
/button> 
<a asp-action="Index" class="btn btn-secondary">Can 
cel</a> 
</form> 

















Edit 视 图 将 显示 以 静态 文本 显示 时 无 法 修改 的 
用 户 ID， 并 提供 编辑 电子 邮件 地 址 和 密码 的 表单 ， 
如 网 28-13 所 示 。 注 意 ， 没 有 对 密码 使 用 标签 助 
手 ， 因 为 AppUser 类 不 包含 密码 信息 ， 只 有 哈 希 值 





你 存在 数据 库 中 。 











图 28-13 ”编辑 用 户 账 户 


最 后 的 修改 是 从 Startup 类 中 注释 挥 用 户 验 证 设 
罩 ， 以 便 用 于 用 户 名 的 默认 字符 可 用 ， 如 代码 清单 
28-31 所 示 。 由 于 数据 库 中 的 茶 些 账户 是 在 更 改 验 
证 设置 之 前 创建 的 ， 因 此 无 法 编辑 它们 ， 这 是 因为 
用 户 名 不 会 通过 验证 。 夯 外 ， 当 电子 邮件 地 址 被 验 
证 时 ， 验 证 将 作用 于 整个 user 对 象 ， 结 果 就 是 用 户 
账户 不 能 修改 。 














代码 清单 28-31 在 Startup.cs 文 件 中 禁用 上 自 定 义 的 验证 设置 


public void ConfigureServices(IServiceCollection servic 


es) { 


services.AddTransient<IPasswordValidator<AppUser>, 
CustomPasswordValidator>(); 

services.AddTransient<IUserValidator<AppUser>, 
CustomUserValidator>(); 


services .AddDbContext<AppIdentityDbContext> (options 


options.UseSqlServer ( 
Configuration[ "Data:SportStoreIdentity:Conn 
ectionString"])); 


services.AddIdentity<AppUser, IdentityRole>(opts => 


opts.User.RequireUniqueEmail = true; 
//opts.User.AllowedUserNameCharacters = "abcdef 
ghijklmnopqrstuvwxyz" ; 

opts.Password.RequiredLength = 6; 
opts.Password.RequireNonAlphanumeric = false; 
opts.Password.RequireLowercase = false; 
opts.Password.RequireUppercase = false; 
opts.Password.RequireDigit = false; 

}) .AddEntityFrameworkStores<AppIdentityDbContext>() 
.AddDefaultTokenProviders() ; 


services.AddMvc(); 





要 测试 编辑 功能 ， 可 运行 应 用 ， 然 后 访 


问 /Admin 并 单 击 Edit 按 钮 。 修 改 电子 邮件 地 址 或 者 
输入 新 密码 ， 单 击 Save 按 钮 以 更 新 数据 库 并 返 
品 /Admin 。 


28.5 ”小 结 


本 章 展 示 了 如 何 创建 使 用 ASP.NET Core 
Identity 所 需 的 配置 和 类 ， 并 演示 了 如 何 应 用 它们 来 
创建 用 户 管理 工具 。 下 一 章 将 展示 如 何 使 用 
ASP.NET Core Identity 执 行 吴 份 验证 和 授权 。 





第 29 章 ”应 用 ASP.NET Core Identity 





本 章 将 展示 如 何 为 上 一 章 创 建 的 用 户 账 号 使 用 
ASP.NET Core Identity 进 行 验证 和 授权 。 表 29-1 列 
出 本 章 要 介绍 的 操作 。 


表 29-1 本 章 要 介绍 的 操作 



































限制 访问 操作 方 
法 




















应 用 Authorize 特 性 















































创建 Account 控 制 器 以 接收 用 户 赁 据 ， 使 用 代码 清单 29-2 一 代码 





















































UserManager 类 检查 凭据 清单 29-5 
































代码 清单 29-6 一 代码 
清单 29-10 











创建 和 管理 使 用 UserManager 类 





























使 用 角色 授权 访 “| 将 用 户 账户 加 入 角色 ， 使 用 Authorize 特 性 指定 “| 代码 清单 29-11 一 代 
问 操作 方法 可 以 访问 操作 方法 的 角色 码 清 单 29-18 



























































代码 清单 29-19 一 代 









































确认 管理 账户 ”| 使 用 种 子 数据 库 自动 创建 账户 码 清单 29-24 





























29.1 准备 示例 项 目 


本 章 将 继续 使 用 你 在 第 28 章 中 创建 的 项 目 。 请 
运行 应 用 程序 并 导航 到 URL 地 址 /Admin， 使 用 
Create 按 钮 确认 表 29-2 中 的 用 户 账户 已 存 入 数据 库 
中 。 





表 29-2 ”本章 需要 的 用 户 账户 




















EF ARH 








完成 后 ， 访 问 /Admin， 将 会 展示 一 个 用 户 列 








表 ， 其 中 包含 表 29-2 中 的 用 户 《〈 不 上 必 介意 创建 的 其 


他 用 户 ， 只 要 表 29-2 中 的 用 户 存 在 即 可 ) ， 如 图 29- 
1 所 示 。 





User 


DD s x 
< S | © localhost:54 Ad 


wl): 


User Accounts 


ID 


004d750d-7101-4bb4-98aa-81f551ce0ff8 Alice alice@example.com 


8c2725c6-6e0f-49af-b082-97f0a69036be Bob bob@example.com 


oe joe@example.com 








图 29-1 执行 示例 应 用 


29.2 ”验证 用 户 





ASP.NET Core Identity 最 基本 的 用 途 就 是 验证 
用 户 。 限 制 访 问 操作 方法 的 关键 工具 是 Authorize 特 
性 ， 它 告诉 MVC 只 有 来 自己 验证 用 户 的 请 求 才 应 该 
被 处 理 。 代 码 清 单 29-1 为 Home 控 制 器 的 Index 操 作 
方法 应 用 了 Authorize 特 性 。 


代码 清单 29-1 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 限制 访问 


using System.Collections.Generic; 
using Microsoft.AspNetCore.Mvc; 
using Microsoft.AspNetCore. Authorization; 


namespace Users.Controllers { 
public class HomeController : Controller { 


[Authorize] 
public ViewResult Index() => 
View(new Dictionary<string, object> { ["Pla 
ceholder"]| = "Placeholder" }); 
} 





} 


如 果 启 动 应 用 ， 浏 览 器 将 发 送 请 求 到 默认 的 
URL 地 址 ， 该 URL 将 针对 使 用 Authorize 修 饰 的 操作 
方法 。 目 前 用 户 无 法 自行 验证 ， 结 果 如 图 29-2 所 
示 。 





| localhost:62542/Account; X 


所 人 localhost62542/A 


Status Code: 404; Not Found 


图 29-2 访问 受 保护 的 action 方 法 的 结果 





Authorize 特 性 没有 指定 如 何 验证 用 户 ， 也 没有 





直接 链接 到 ASP.NET Core Identity。 验 证 服务 和 中 
间 件 将 路 越 整个 ASP.NET Core 平 台 ， 通 过 修改 描述 
HTTP 请 求 的 上 下 文 对 象 ， 可 以 简单 流畅 地 与 MVC 
应 用 集成 ， 将 验证 处 理 的 详细 结果 提供 给 MVC 应 用 
而 不 用 涉及 内 部 细 市 。 





ASP.NET Core 平 台 通 过 HttpContext 对 象 来 提供 
天 于 用 户 的 信息 ， 该 对 象 被 Authorize 特 性 用 来 检查 
当前 请 求 的 用 户 状态 和 查看 用 户 是 否 已 被 验证 。 
HttpContext.User 属 性 返回 一 个 实现 了 IPrincipla 接 口 
的 实例 ， 这 个 接口 定义 在 命名 空间 
System.Security.Principal 中 。IPrincipal 接 口中 的 重 
要 成 员 包括 Identity 属 性 和 IsImRole(role) 方 法 。 














Identity 属 性 返回 接口 TIidentity 的 实现 ，IIdentity 
接口 搞 述 了 请 求 关 联 的 用 户 。 








如 果 用 户 是 特定 角色 的 成 员 ，ISInRole(role) 方 


法 则 返回 true。 


你 可 通过 IPrincipal.Identity 属 性 返回 Identity 接 
口 的 实现 ， jpe H HIJE TER E — ERF 
采用 户 的 信息 。 








表 29-3 ”定义 在 IIdentity 接 口中 的 重要 属性 























AuthenticationType i 于 用 户 验证 机 制 的 描述 字符 串 
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第 30 章 将 介绍 ASP.NET Core Identity PFR F 
IIdentity 接 口 的 实现 类 。 


ASP.NET Core Identity 中 间 件 使 用 浏览 需 返 回 
的 Cookie 来 检查 用 户 是 否 已 经 通过 验证 。 如 果 用 户 
己 经 通过 验证 ， 就 把 Identity.ISAuthenticated 属 性 设 
置 为 true。 由 于 当前 的 示例 应 用 还 没有 提供 验证 机 
制 ， 因 此 IsAuthenticated 属 性 总 是 返回 false。 这 将 导 
致 验证 错误 ， 使 客户 端 被 重 定 同 到 地 
址 /AccountLogin， 这 是 提供 验证 凭据 的 默认 地 
He 
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器 返回 404-Not Found 啊 应 ， 导 致 的 错误 消息 参见 图 
29-2 。 





改变 登录 地 址 


虽然 /AccountVLogin 是 需要 验证 时 客户 端 默认 
的 重 定 同 地 址 ， 但 是 在 设置 ASP.NET Core Identity 
服务 的 时 候 ， 可 以 在 Startup 类 的 ConfigureServices 
方法 中 修改 配置 选项 来 指定 目 己 的 地 址 ， 如 下 所 
JN: 








services.ConfigureApplicationCookie(opts => opts.LoginP 





ath = "/Users/Login"); 


由 于 不 能 依赖 路 由 系统 来 生成 URL 地 址 ， 因 此 
必须 使 用 字面 值 来 设 定 重 定 同 目标 。 如 果 为 应 用 修 
改 了 路 由 模式 ， 束 必须 确 你 同时 修改 了 ASP.NET 
Core Identity 设 置 ， 以 便 这 个 地 址 还 可 以 到 达 目 标 
FE till ae 





29.2.1 准备 实现 验证 


请 求 虽 然 以 错误 结束 ， 但 还 是 展示 了 ASP.NET 
Core Identity 如 何 适 配 标准 的 ASP.NET 请 求生 命 周 
期 。 下 一 步 ， 我 们 将 实现 一 个 接收 请 求 并 验证 用 户 
的 控制 器 。 如 代码 清单 29-2 所 示 ， 添 加 一 个 新 的 模 
型 类 到 UserViewModels.cs 文 件 中 。 


代码 清单 29-2 ”在 Models 文 件 夹 下 的 UserViewModels.cs 文 件 中 
添加 新 的 模型 类 





using System.ComponentModel.DataAnnotations; 


namespace Users.Models { 


public class CreateModel { 


[Required | 
public string Name { get; set; } 
[Required | 
public string Email { get; set; } 
[Required] 


public string Password { get; set; } 


} 
public class LoginModel { 


[Required ] 
[UIHint( "email" ) ] 
public string Email { get; set; } 


[Required] 
[UIHint("password")] 
public string Password { get; set; } 





这 个 新 的 模型 拥有 Email 和 Password 属 性 ， 它 们 
都 使 用 Required 特 性 进行 修饰 ， 所 以 可 以 使 用 模型 
验证 来 检查 用 户 是 否 提 供 了 这 些 值 。 还 可 以 使 用 
UIHint 特 性 来 修饰 这 些 属性 ， 这 将 使 标签 助手 在 视 
图 中 渔 染 的 input 元 系 拥 有 合适 的 type 属 性 。 








提 示 


在 真实 项 目 中 ， 客 户 闻 验证 可 以 在 提交 表单 到 





服务 占 之 前 检查 用 户 提供 的 用 户 名 和 和 密码， 详 见 第 
gi 


添加 名 为 AccountController.cs 的 类 文件 到 
Controllers 文 件 夹 中 ， 定 义 代 码 清单 29-3 所 示 的 控 
HIAS o 


代码 清单 29-3 Controllers X44% F A) AccountController.cs X4} 
的 内 容 





using System.Threading.TasKs ; 

using Microsoft.AspNetCore. Authorization; 
using Microsoft.AspNetCore.Mvc; 

using Users.Models; 


namespace Users.Controllers { 


[Authorize ] 
public class AccountController : Controller { 


[ AllowAnonymous | 

public IActionResult Login(string returnUrl) { 
ViewBag.returnUrl = returnUr1; 
return View(); 


[HttpPost ] 
[ AllowAnonymous ] 
[ValidateAntiForgeryToken | 
public async Task<IActionResult> Login(LoginMod 
el details, string returnUrl) { 
return View(details) ; 





里 还 没有 实现 验证 逻辑 ， 下 面 首 先 定 义 视 
图 ， 然 后 演示 检验 用 户 攒 据 的 过 程 以 及 用 户 登 录 应 
用 的 过 程 。 








虽然 还 没有 验证 用 户 ， 但 Account 控 制 嚣 包含 
了 一 些 有 用 的 基础 染 构 ， 可 从 ASP.NET Core 
Identity 代 码 中 分 别 说 明 这 些 不 久 就 要 添加 a 到 Login 
操作 方法 的 内 容 。 


注意 ， 两 个 版 本 的 Login 操 作 方 法 都 有 一 个 名 
为 retumUrl 的 参数 。 当 用 户 访问 受 限 的 地 址 时 ， 他 
们 将 被 重 定 同 到 带 有 指 癌 党 限 地 址 的 得 询 串 的 地 











址 /AccountVLogin， 一 旦 用 户 被 验证 ， 残 可 以 返回 
这 个 地 址 。 如 采 局 动 应 用 并 访问 地 址 /再 ome/Index， 
残 可 以 看 到 这 些 。 你 的 浏览 夯 将 会 被 重 定 同 ， 如 下 
所 示 : 


/Account/Login?ReturnUrl=%2FHome%2FIndex 


ReturnUrl 参 数 的 字符 串 值 使 得 打开 页 面 和 安全 
处 理 之 间 的 页 面 重 定 同 处 理 变 得 平滑 和 无 缝 。 





接 下 来 ， 注 意 应 用 于 Account 控 制 器 的 特性 。 
管理 用 户 账号 的 控制 器 包含 只 有 验证 用 户 才 能 使 用 
的 功能 ， 例 如 重 置 口令 。 我 们 最 终 为 控制 右 应 用 了 
Authorize 特 性 ， 然 后 为 个 别 操作 方法 应 用 了 
AllowAnonymous 特 性 。 这 样 ， 默 认 的 操作 方法 需 
要 验证 用 户 ， 但 是 允许 未 验证 用 户 登 录 应 用 。 这 里 
还 应 用 了 ValidateAntiForgeryToken 特 性 ， 第 24 章 介 
绍 过 ， 从 而 与 表单 元 系 的 标签 助手 协作 以 防止 跨 站 











仿冒 攻击 。 


最 后 的 准备 步骤 是 创建 用 户 获 取 和 攒 据 的 视图 。 
创建 Views/Account 文 件 夹 ， 添 加 名 为 Login.cshtml 
的 视图 文件 ， 内 容 如 代码 清单 29-4 所 示 。 


代码 清单 29-4 Views 人 Account 文件 夹 下 的 Login.cshtml 文 件 的 
内 容 





@model LoginModel 


<div class="bg-primary m-1 p-1 text-white"><h4>Log In</ 
h4></div> 


<div class="text-danger" asp-validation-summary="Al1">< 
/div> 


<form asp-action="Login" method="post"> 
<input type="hidden" name="returnUr1l" value="@ViewB 
ag.returnUrl" /> 
<div class="form-group"> 
<label asp-for="Email"></label> 
<input asp-for="Email" class="form-control" /> 
</div> 
<div class="form-group"> 
<label asp-for="Password"></label> 
<input asp-for="Password" class="form-control" 
/> 
</div> 


<button class="btn btn-primary“ type="submit">Log I 
n</button> 
</form> 








Login 视 图 中 唯一 需要 注意 的 就 是 hidden 输 入 元 
素 ， 这 里 用 来 保持 returnUrl 参 数 。 从 任何 其 他 方面 
看 ，Login 都 是 标准 的 Razor 视 图 ， 并 且 完 成 了 验证 
的 准备 工作 ， 演 示 了 未 经 验证 的 请 求 被 拦截 和 和 音 定 
问 的 方式 。 测 试 这 个 新 的 控制 器 ， 局 动 应 用 ， 当 浏 
览 右 请求 应 用 程序 的 默认 地 址 时 ， 重 定 回 到 地 
址 /Account/Login， 生 成 的 内 容 如 图 29-3 所 示 。 








图 29-3 ”生成 的 内 容 


29.2.2 ”添加 用 户 验 证 





请 求 保 护 的 操作 方法 已 被 正确 重 定 同 到 
Account 控 制 器 ， 但 是 用 户 提供 的 凭据 还 没有 被 验 
证 。 代 码 清单 29-5 完 整 实 现 了 Login 操 作 方 法 ， 并 使 
用 ASP.NET Core Identity 服 务 根据 存储 在 数据 库 中 
的 详细 内 容 来 验证 用 户 。 


代码 清单 29-5” 在 Controllers 文 件 夹 下 的 AccountController.cs 文 
件 中 添加 用 户 验 证 





using System.Threading.Tasks; 

using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Mvc; 

using Users.Models; 

using Microsoft.AspNetCore.Identity; 


namespace Users.Controllers { 


[Authorize] 

public class AccountController : Controller { 
private UserManager<AppUser> userManager; 
private SignInManager<AppUser> SignInManager; 


public AccountController(UserManager<AppUser> u 
serMgr, 
SignInManager<AppUser> signinMgr) { 
userManager = userMgr; 
signInManager = signinMgr; 


[ AllowAnonymous | 

public IActionResult Login(string returnUrl) { 
ViewBag.returnUrl = returnUr1; 
return View(); 


} 


[HttpPost] 
[AllowAnonymous] 
[ValidateAntiForgeryToken] 
public async Task<IActionResult> Login(LoginMod 
el details, 
string returnUrl) { 
if (ModelState.IsValid) { 
AppUser user = await userManager.FindBy 
EmailAsync(details.Email) ; 
if (user != null) { 
await signInManager.SignOutAsync(); 
Microsoft.AspNetCore.Identity.SignI 
nResult result = 
await signInManager.Passwor 
dSigniInAsync( 
user, details.Password, 
false, false); 
if (result.Succeeded) { 
return Redirect(returnUrl ?? "/ 
")3 
} 
} 
ModelState.AddModelError (nameof (LoginMo 
del.Email), 
"Invalid user or password") ; 


} 


return View(details) ; 


以 上 代码 中 最 简单 的 部 分 是 获取 用 于 表示 用 户 
的 AppUser 对 象 ， 可 使 用 UserManager<AppUser> 关 
的 FindByEmailAsync 方 法 来 完成 : 











AppUser user = await userManager.FindByEmailAsync(detai 


1ls.Email) ; 








这 个 方法 使 用 已 经 创建 的 电子 邮件 地 址 来 定位 
用 户 。 另 外 一 些 候 选 的 用 于 定位 用 户 的 方式 有 使 用 
ID、 用 户 名 以 及 登录 等 。 这 里 使 用 电子 邮件 地 址 进 
行 登录 ， 因 为 这 种 方式 可 由 大 多 数 面 向 互联 网 的 
Web 应 用 采用 ， 而 且 在 企业 级 应 用 中 变 得 越 来 越 流 
行 。 














如 条 存 在 包含 用 户 指定 的 电子 邮件 地 址 的 账 
尸 ， 下 一 步 就 是 执行 验证 ， 由 于 需要 使 用 
SignInManager<AppUser> 类 ， 因 此 还 加 通过 依赖 注 


入 获取 的 构造 水 数 参 数 。 可 使 用 SignInManager 类 执 


行 两 个 验证 步骤 : 


await signInManager.SignOutAsync( ) ; 
Microsoft.AspNetCore.Identity.SignInResult result = 


await signInManager.PasswordSignInAsync(user, detai 
ls.Password, false, false); 





SignOutAsync 方 法 取消 用 户 拥 有 的 任何 现 有 会 
话 ，PasswordSignIn 方 法 执行 验证 。 
PasswordSignInAsync 方 法 的 参数 包括 用 户 对 象 、 用 
户 提 供 的 密码 以 及 用 于 控制 身份 验证 的 Cookie 是 人 否 
应 该 持久 的 bool 参 数 〈 已 被 禁用 ) 。 这 个 bool 参 数 
还 决定 了 如 条 密码 正确 ， 账 号 是 否 应 该 被 锁定 〈 也 
己 茶 用 ) 。 








PasswordSignInAsync 方 法 的 返回 结果 是 一 个 
SignInResult 对 象 ， 其 中 定义 了 名 为 Succeeded 的 bool 
属性 来 标识 验证 是 否 已 经 成 功 。 





在 这 个 示例 中 ， 检 查 Succeeded 属 性 。 如 果 值 
为 true， 束 将 用 户 重 定 同 到 returnUrl 地 址 ， 否 则 ， 添 
加 验证 错误 消息 ， 然 后 重新 显示 Login 视 图 以 便 用 
户 可 以 重新 答 试 登录 。 








作为 验证 过 程 的 一 部 分 ，ASP.NET Core 
[Identity 添加 了 一 个 Cookie 到 响应 中 ， 以 便 浏 ‘ule 
随后 的 请 求 中 携带 这 个 Cookie， 它 将 用 来 标识 用 
的 会 话 和 关联 的 用 户 账 号 。 不 必 直 接 创 建 或 管理 这 
个 Cookie， 它 将 被 ASP.NET Core Identity "F lA) K 
动 处 理 。 











考虑 双 因 子 验 证 


执行 单 因 了 于 验证 ， 以 便 用 户 可 以 使 用 他 们 已 经 
提前 知道 的 信息 一 一 密码 进行 验证 。 





ASP.NET Core Identity FPE X FEN A F RE, 
ECE AP m 22 SM, a ee TESLA PA 
份 时 给 予 用 户 的 信息 。 最 第 见 的 是 来 目 SecureID 令 
牌 的 值 以 及 来 目 邮 件 或 短信 的 验证 码 《〈 严 格 来 说 ， 
双 因 子 可 以 是 任何 因素 ， 包 括 指 纹 、 虹 膜 扫 搞 、 声 
音 识 别 ， 虽 然 这 些 是 大 多 数 Web 应 用 很 少 需要 的 选 
项 ) 。 





由 于 攻击 者 需要 知道 用 户 的 密码 并 且 需 要 第 二 
个 因子 ， 因 此 电子 邮件 账户 或 手机 的 安全 性 被 加 强 
Ja 











有 两 个 原因 导致 本 书 不 会 展示 双 因子 验证 。 首 
先 ， 因 为 需要 做 大 量 的 准备 工作 ， 比 如 设置 分 发 作 
为 第 二 个 因子 的 电子 邮件 地 址 和 短信 的 基础 架构 ， 
并 且 实 现 验证 逻辑 ， 所 有 这 些 都 超出 了 本 书 的 讨论 
范围 。 


其 次 ， 因 为 双 因 子 验证 迫使 用 户 记 住 要 跳 到 知 
外 的 步骤 进行 验证 ， 比 如 记 住 目 己 的 电话 号 码 或 者 
保持 SecureID 令 牌 在 手边 ， 有 些 方式 不 便于 在 Web 
应 用 中 使 用 。 





如 果 对 双 因 子 验证 感 兴趣 ， 建 议 基 于 第 三 方 系 
统 〈 比 如 Google) 进行 验证 ， 这 将 允许 用 户 选 择 目 
己 和 希望 的 双 因 子 验证 额外 的 安全 信息 。 第 30 草 将 演 
不 第 三 方 验证 。 


29.2.3 ”测试 验证 


为 了 测试 验证 ， 可 局 动 应 用 并 请 求 地 
址 /Home/Index。 当 被 重 定 问 到 地 址 /Account/Login 
后 ， 输 入 本 章 开 头 列 出 的 用 户 信 息 〈 例 如 ， 电 子 邮 
件 地 址 joe@example.com 和 和 密码 secret123) 。 单 击 
Log In 按钮， 浏览 右 将 被 重 定 同 到 地 


址 /Home/Index。 但 是 ， 此 时 将 提交 验证 Cookie， 使 
得 被 授权 访问 这 个 操作 方法 ， 如 图 29-4 所 示 。 











图 29-4 ”验证 用 户 


fe 未 








使 用 浏览 器 的 开发 人 员工 具 可 以 查看 用 于 标识 
验证 请 求 的 Cookie。 


29.3 (EH A ERAH AP 





之 前 ， 特 性 Authorize 以 最 基本 的 方式 使 用 ， 
将 允许 任何 经 过 验证 的 用 户 执 行 操作 方法 。 基 于 用 
户 的 成 员 角 色 ， 还 可 以 优化 授权 ， 对 根据 哪些 用 户 
执行 哪些 操作 进行 精细 控制 。 


角色 仅仅 是 在 应 用 中 自 定 义 的 表示 一 组 活动 权 
限 的 定制 标签 。 几 乎 所 有 的 应 用 都 区 分 可 以 执行 管 
理 功 能 的 用 户 和 没有 管理 功能 的 用 户 。 在 角色 的 世 
界 中 ， 可 通过 创建 Administrators 角 色 并 赋予 用 户 来 
实现 授权 。 用 户 可 以 隶属 于 多 个 角色 ， 和 角色 的 权限 
可 以 是 粗放 的 ， 也 可 以 是 细 粒 度 的 。 因 此 ， 可 以 使 
用 单独 的 角色 来 区 分 可 以 执行 基本 任务 的 管理 员 
《比如 创建 新 的 账号 ) ， 以 及 可 以 执行 更 敏感 操作 
的 用 户 〈《 比 如 访问 付款 数据 〉。 











ASP.NET Core Identity 负 责 管理 定义 在 应 用 中 





的 角色 ， 并 跟 踩 隶属 于 每 个 角色 的 用 户 成 员 ， 但 是 
它 不 知道 每 个 角色 的 意义 ， 这 些 信 息 包 含 在 应 用 的 
MVC 部 分 ， 并 基于 角色 成 员 来 限制 对 操作 方法 的 访 
问 。 











ASP.NET Core Identity 提 供 了 基于 强 类 型 的 名 
为 RoleManager<T> 的 基 类 来 访问 和 管理 角色 ， 这 里 
的 T 就 是 存储 机 制 中 表示 角色 的 类 。Entity 
Framework Core 使 用 名 为 IdentityRole 的 类 ， 其 中 定 
义 的 属性 如 表 29-4 所 示 。 


表 29-4 ”IdentityRole 类 定义 的 属性 




















nen me 























inal 
返回 表示 角色 成 员 的 IdentityUserRole 对 象 集合 














如 有 果 硕 望 扩 展 内 置 的 功能 ， 可 以 创建 应 用 特定 
的 角色 类 ， 第 30 草 将 说 明 用 户 对 象 ， 但 是 这 里 将 继 
续 使 用 IdentityRole 类 ， 这 是 因为 该 类 可 以 完成 大 多 
数 应 用 需要 的 所 有 工作 。 第 28 音 在 配置 应 用 的 时 候 
己 经 告诉 ASP.NET Core Identity 使 用 IdentityRole 来 
表示 角色 ， 详 见 Startup 类 的 ConfigureService 方 法 中 
的 代码 : 


services.AddIdentity<AppUser, IdentityRole>(opts => { 
opts.User.RequireUniqueEmail = true; 
//opts.User.AllowedUserNameCharacters = "abcdefghij 
klmnopgqrstuvwxyz" ; 
opts.Password.RequiredLength = 6; 


opts.Password.RequireNonAlphanumeric = false; 
opts.Password.RequireLowercase = false; 
opts.Password.RequireUppercase = false; 
opts.Password.RequireDigit = false; 

}) .AddEntityFrameworkStores<AppIdentityDbContext>() 
.AddDefaultTokenProviders() ; 





AddIdentity 方 法 的 类 型 参数 指定 了 将 用 来 表示 
用 户 和 角色 的 类 。 在 示例 应 用 中 ，AppUser 关 用 来 





表示 用 户 ， 内 置 的 IdentityRole 类 用 来 表示 角色 。 
29.3.1 创建 与 删除 角色 


为 了 演示 如 何 使 用 角色 ， 下 面 创建 一 个 管理 工 
具 来 管理 它们 ， 首 先 创 建 可 以 用 来 创建 和 删除 角色 
的 操作 方法 。 在 Controllers 文 件 夹 中 创建 名 为 
RoleAdminController.cs 的 类 文件 ， 用 它 定 义 代码 清 
单 29-6 所 示 的 控制 占 。 


代码 清单 29-6 ”Controllers 文 件 夹 下 的 RoleAdminController.cs 
文件 的 内 容 





using System.ComponentModel .DataAnnotations; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore.Identity; 

using Microsoft.AspNetCore. Identity. EntityFrameworkCore 


3 
using Microsoft.AspNetCore.Mvc; 
namespace Users.Controllers { 


public class RoleAdminController : Controller { 
private RoleManager<IdentityRole> roleManager ; 
public RoleAdminController(RoleManager<Identity 
Role> roleMgr) { 


roleManager = roleMgr; 


} 


public ViewResult Index() => View(roleManager.R 
oles); 


public IActionResult Create() => View(); 


[HttpPost] 
public async Task<IActionResult> Create([Requir 
ed|jstring name) { 
if (ModelState.IsValid) { 
IdentityResult result 
= await roleManager.CreateAsync (new 
IdentityRole(name) ) ; 
if (result.Succeeded) { 
return RedirectToAction("Index") ; 
} else { 
AddErrorsFromResult(result) ; 


} 
} 
return View(name) ; 
} 
[HttpPost ] 


public async Task<IActionResult> Delete(string 
id) { 
IdentityRole role = await roleManager.FindB 
yIdAsync(id); 
if (role != null) { 
IdentityResult result = await roleManag 
er.DeleteAsync(role); 
if (result.Succeeded) { 
return RedirectToAction("Index") ; 
} else { 
AddErrorsFromResult(result) ; 


} else { 
ModelState.AddModelError("", "No role f 
ound"); 


return View( "Index", roleManager.Roles) ; 


} 


private void AddErrorsFromResult(IdentityResult 
result) { 
foreach (IdentityError error in result.Erro 
rs) { 
ModelState.AddModelError("", error.Desc 


ription); 





角色 使 用 RoleManager<T> 类 进行 管理 ， 这 里 的 
T 是 用 来 表示 和 角色 的 类 (示例 应 用 使 用 了 内 置 的 
IdentityRole 类 ) . RoleAdminController#4ié PK žit E 
X. Y #EF RoleManager<IdentityRole> fH) #4) i K ZUK 
赖 ， 当 控制 费 修 创建 时 ， 可 通过 依赖 注入 获取 。 








RoleManager<T> 类 定义 了 表 29-5 所 示 的 方法 和 
属性 ， 它 们 允许 创建 和 管理 角色 。 


表 29-5 ”RoleManager<T> 类 定义 的 成 员 


" l 
CreateAsync(role) 创建 新 角色 
DeleteAsync(role) 删除 特定 角色 


FindByldAsync(id) 使 用 ID 发 现 角色 












































FindByNameAsync(name) 使 用 角色 名 称 发 现 角 色 


RoleExistsAsync(name) 如 果 特 定名 称 的 角色 存在 ， 则 返回 true 




















UpdateAsync(role) 为 特定 角色 存储 更 新 
返回 定义 角色 的 枚 举 


新 控制 器 的 Index 操 作 方 法 将 显示 应 用 中 的 所 
有 角色 。Create 操 作 方 法 被 用 来 显示 和 接收 表单 ， 
来 自 表 单 的 信息 将 被 CreateAsync 方 法 用 来 创建 新 的 
角色 。Delete 操 作 方 法 接收 POST 类 型 的 请 求 和 唯一 
的 角色 标识 ， 使 用 FindByIdAsync 方 法 来 定位 ID 表 



































示 的 角色 对 象 ， 并 使 用 DeleteAsync 方 法 从 应 用 中 删 
除 角色 。 


1. 创建 视图 





为 了 在 应 用 中 显示 角色 的 详情 ， 创 建 
Views/RoleAdmin 文 件 夹 ， 在 其 中 添加 名 为 
Index.cshtml 的 视图 文件 ， 内 容 如 代码 清单 29-7 所 
不 。 


代码 清单 29-7 Views/RoleAdmin 文 件 夹 下 的 Index.cshtml 文 件 
的 内 容 





@model IEnumerable<IdentityRole> 


<div class="bg-primary m-1 p-1"><h4>Roles</h4></div> 


<div class="text-danger" asp-validation-summary="ModelO 
nly"></div> 


<table class="table table-sm table-bordered table-borde 
red"> 
<tr><th>ID</th><th>Name</th><th>Users</th><th></th> 
</tr> 
@if (Model.Count() == @) { 
<tr><td colspan="4" class="text-center">No Role 


s</td></tr> 
} else { 
foreach (var role in Model) { 
<tr> 
<td>@role.Id</td> 
<td>@role.Name</td> 
<td identity-role="@role.Id"></td> 
<td> 
<form asp-action="Delete" asp-route 
-id="@role.Id" method="post"> 
<a class="btn btn-sm btn-primar 
y" asp-action="Edit" 
asp-route-id="@role.Id">Edit 


</a> 
<button type="submit" 
class="btn btn-sm btn-d 
anger"> 
Delete 
</button> 
</form> 
</td> 
</tr> 
} 
} 
</table> 


<a class="btn btn-primary" asp-action="Create">Create</ 
a> 











Imdex 视 图 使 用 表格 来 显示 应 用 角色 的 详细 信 
恩 ， 其 中 的 第 三 列 使 用 了 定制 的 元 素 属 性 ， 如 下 所 


Sd 


ZN: 








<td identity-role="@role.Id"></td> 











为 了 显示 每 个 角色 相关 的 成 员 列 表 ， 需 要 在 视 
图 中 包含 大 量 的 代码 。 eg 添加 一 
个 名 为 RoleUsersTagHelper.cs 的 类 文件 到 
Ingrastructure 文 件 夹 中 ， 用 它 定 义 代码 清单 29-8 所 
示 的 标签 助手 。 





代码 清单 29-8 ”Infrastructure 文 件 夹 下 的 RoleUsersTagHelper.cs 
文件 的 内 容 





using System.Collections.Generic; 

using System.Threading.Tasks; 

using Microsoft.AspNetCore.Identity; 

using Microsoft.AspNetCore.Identity.EntityFrameworkCore 


2 
using Microsoft.AspNetCore.Razor.TagHelpers; 
using Users.Models; 


namespace Users.Infrastructure { 


[HtmlTargetElement("td", Attributes = "identity-rol 
e")] 
public class RoleUsersTagHelper : TagHelper { 
private UserManager<AppUser> userManager; 


private RoleManager<IdentityRole> roleManager ; 


public RoleUsersTagHelper(UserManager<AppUser > 
usermgr, 
RoleManager<IdentityR 
ole> rolemgr) { 
userManager = usermgr; 
roleManager = rolemgr; 


} 


[HtmlAttributeName("identity-role")] 
public string Role { get; set; } 


public override async Task ProcessAsync(TagHelp 
erContext context, 
TagHelperOutput output) { 


List<string> names = new List<string>(); 
IdentityRole role = await roleManager.FindB 
yIdAsync(Role); 
if (role != null) { 
foreach (var user in userManager.Users) 


if (user != null 
&& await userManager.IsInRoleAs 
ync(user, role.Name)) { 
names.Add(user.UserName) ; 


} 
} 


output.Content.SetContent(names.Count == 


"No Users" : string.Join(", ", names)); 


这 个 标签 助手 处 理 td 元 素 的 identity-role 属 性 ， 
用 它 接 收 被 处 理 角 色 的 ID。 
RoleManager<IdentityRole> 和 
UserNamager<AppUser> 对 象 允许 得 询 Identity 数 据 
库 来 构建 角色 中 的 用 户 名 列表 。 代 码 清 日 29-9 将 这 
个 标签 助手 添加 到 视图 的 导入 文件 中 ， 并 且 添 加 
@using expression， 以 便 在 视图 中 不 通过 命名 空间 
使 用 Entity Framework Core 中 的 类 型 。 

















代码 清单 29-9 ”在 Views 文 件 夹 下 的 ViewImports.cshtml 文 件 中 
添加 标签 助手 


@using Users.Models 
@using Microsoft.AspNetCore. Identity 


@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 
@addTagHelper Users.Infrastructure.*, Users 





然后 ， 添 加 名 为 Create.cshtml 的 视图 文件 到 
Views/RoleAdmin 文 件 夹 中 ， 并 且 添 加 代码 清单 29- 





10 所 示 的 标记 来 文 持 添加 角色 。 


代码 清单 29-10 ”Views/RoleAdmin 文 件 夹 下 的 Create.cshtml 文 
件 的 内 容 


@model string 


<div class="bg-primary m-1 p-1"><h4>Create Role</h4></d 
iv> 


<div asp-validation-summary="All" class="text-danger">< 
/div> 


<form asp-action="Create" method="post"> 


<div class="form-group"> 
<label for="name"></label> 
<input name="name" class="form-control" /> 
</div> 
<button type="submit" class="btn btn-primary">Creat 
e</button> 
<a asp-action="Index" class="btn btn-secondary">Can 
cel</a> 
</form> 





创建 角色 时 唯一 需要 的 表单 数据 是 角色 名 称 ， 
这 束 是 使 用 string 类 型 作为 Create 视 图 的 视图 模型 类 
的 原因 。 信 用 模型 验证 的 优势 可 以 确认 在 提 区 表单 
的 时 候 用 户 提 供 了 值 ， 但 是 不 值得 为 了 这 么 简单 的 








任务 创建 专门 的 模型 类 。 相 反 ， 观 察 代码 清单 29-6 
中 接收 POST 请 求 的 Create 操 作 方 法 ， 你 会 看 到 直接 
在 参数 中 使 用 了 Required 验 证 特性 。 这 与 在 模型 类 
中 使 用 这 个 特性 有 同样 的 效果 ， 而 且 人 允许 获得 内 置 
的 模型 验证 市 来 的 好 处 。 


2. 测试 、 创 建 与 删除 角色 


为 了 测试 新 的 控制 器 ， 启 动 应 用 后 导航 到 URL 
地 址 /RoleAdmin， 单 击 Create 按 钮 ， 在 input 元 素 中 
输入 名 字 ， 然 后 单 击 男 一 个 Create 按 钮 。 新 的 角色 
将 保存 到 数据 库 中 ， 在 浏览 右 被 重 定 同 到 Index 操 作 
后 将 显示 出 来 ， 如 图 29-5 所 示 。 单 击 Delete 按 钮 ， 
从 应 用 中 删除 这 个 角色 。 











图 29-5 ”创建 新 角色 
29.3.2 ”管理 角色 成 员 


下 一 步 是 在 角色 中 添加 和 删除 用 户 。 这 个 过 程 
并 不 复杂 ， 但 是 它 调 用 了 来 目 RoleManager 关 的 角 
色 数 据 ， 并 将 它们 与 单个 用 户 的 详情 相关 联 。 





首先 定义 一 些 视 图 模型 类 ， 它 们 用 来 表示 角色 
的 成 员 资 格 ， 并 从 用 户 那 里 接收 一 组 新 的 成 员 资 
格 ， 代 码 清单 29-11 展 示 了 在 Models 文 件 夹 中 创建 
的 UserViewModels.cs 文 件 。 


代码 清单 29-11 添加 视图 模型 到 UserViewModels.cs 文 件 中 





using System.ComponentModel .DataAnnotations; 
using System.Collections.Generic; 
using Microsoft.AspNetCore.Identity; 


namespace Users.Models { 
public class CreateModel { 
[ Required | 
public string Name { get; set; } 
[Required | 


public string Email { get; set; } 

[Required] 

public string Password { get; set; } 
} 


public class LoginModel { 
[Required] 
[UIHint("email")] 
public string Email { get; set; } 
[Required] 
[UIHint("password")] 
public string Password { get; set; } 


} 
public class RoleEditModel { 
public IdentityRole Role { get; set; } 
public IEnumerable<AppUser> Members { get; set; 


public IEnumerable<AppUser> NonMembers { get; s 


public class RoleModificationModel { 
[Required ] 
public string RoleName { get; set; } 
public string RoleId { get; set; } 
public string[] IdsToAdd { get; set; } 
public string[] IdsToDelete { get; set; } 








RoleEditModel 类 表示 系统 中 角色 及 用 户 的 详细 
nds, REH ER EA BEN MET. 





RoleModification- Model 类 表示 针对 角色 的 一 组 更 
HT o 


代码 清单 29-12 展 示 了 RoleAdmin 控 制 器 中 新 添 
加 的 操作 方法 ， 它 们 使 用 代码 清单 29-11 所 示 的 视 
图 模型 来 管理 角色 成 员 。 








代码 清单 29-12 ”在 Controllers 文 件 夹 下 的 
RoleAdminController.cs 文 件 中 添加 操作 方法 





using System.ComponentModel.DataAnnotations; 
using System. Threading. Tasks; 

using Microsoft.AspNetCore. Identity; 

using Microsoft.AspNetCore.Mvc; 

using Users.Models; 

using System.Collections.Generic; 


namespace Users.Controllers { 


public class RoleAdminController : Controller { 
private RoleManager<IdentityRole> roleManager ; 
private UserManager<AppUser> userManager ; 
public RoleAdminController(RoleManager<Identity 
Role> roleMgr, 
UserManager<AppUser> 
userMrg) { 
roleManager = roleMgr; 
userManager = userMrg; 


} 


// ...other action methods omitted for brevity. 


public async Task<IActionResult> Edit(string id 
) { 


IdentityRole role = await roleManager.FindB 


ylIdAsync(id); 
List<AppUser> members = new List<AppUser>(); 


List<AppUser> nonMembers = new List<AppUser 


>(); 
{ 


foreach (AppUser user in userManager.Users) 


var list = await userManager.IsInRoleAs 
ync(user, role.Name) 
? members : nonMembers; 
list.Add(user); 
} 
return View(new RoleEditModel { 
Role = role, 
Members = members, 
NonMembers = nonMembers 


}); 
} 


[HttpPost] 
public async Task<IActionResult> Edit(RoleModif 
icationModel model) { 
IdentityResult result; 
if (ModelState.IsValid) { 
foreach (string userId in model.IdsToAd 


d ?? new string[] { }) { 
AppUser user = await userManager.Fi 


ndByIdAsync(CuserId ) ; 
if (user != null) { 
result = await userManager.AddT 
oRoleAsync(user, 
model.RoleName) ; 
if (!result.Succeeded) { 
AddErrorsFromResult (result) ; 


} 


foreach (string userId in model.IdsToDe 
lete ?? new string[] { }) { 
AppUser user = await userManager.Fi 
ndByIdAsync(userId) ; 
if (user != null) { 
result = await userManager .Remo 
veFromRoleAsync(user, 
model.RoleName) ; 
if (!result.Succeeded) { 
AddErrorsFromResult (result) ; 


} 
} 
if (ModelState.IsValid) { 
return RedirectToAction(nameof (Index) ) ; 
} else { 
return await Edit(model.RoleId) ; 
} 
} 


private void AddErrorsFromResult(IdentityResult 
result) { 


foreach (IdentityError error in result.Erro 


rs) { 
ModelState.AddModelError("", error.Desc 


ription); 





在 GET 版 本 的 Edit 操 作 方 法 中 ， 大 部 分 代码 用 
来 生成 针对 所 选 角 色 的 成 员 集 合 和 非 成 员 集合 。 
旦 所 有 用 户 分 类 完成 ， 一 个 新 的 RoleEditModel 实 例 
就 被 传递 给 View 方 法 ， 以 便 这 些 数据 可 以 使 用 默认 
视图 显示 出 来 。 








POST 版 本 的 Edit 操 作 方 法 负责 在 角色 中 添加 或 
删除 用 户 。UserManager<T> 类 提供 了 一 些 处 理 角 色 
的 方法 ， 如 表 29-6 所 示 。 





表 29-6 ”UserManager<T> 类 定义 的 角色 相关 方法 



































AddToRoleAsync(user,name) 将 用 户 ID 添加 到 具有 指定 名 称 的 角色 中 

















户 的 角色 成 员 名 称 列表 











昌 户 是 指定 角色 的 成 员 ， 返 回 true 























这 些 方 法 的 奇怪 之 处 在 于 角色 相关 的 操作 方法 
其 于 角色 名 称 来 执行 操作 ， 即 便 角 色 拥 有 唯一 的 标 
识 。 正 因为 如 此 ，RoleModificationModel 视 图 模型 
类 有 一 个 RoleName 属 性 。 


创建 Edit.cshtm] 文 件 并 把 它 添加 到 
Views/RoleAdmin fhe, FEE MARS 29- 
13 所 示 的 标记 以 允许 用 户 编 辑 角 色 成 员 。 





代码 清单 29-13 ”Views/RoleAdmin 文 件 夹 下 的 Edit.cshtml 文 件 
的 内 容 





@model RoleEditModel 


<div class="bg-primary m-1 p-1 text-white"><h4>Edit Rol 
e</h4></div> 


<div asp-validation-summary="All" class="text-danger">< 
/div> 


<form asp-action="Edit" method="post"> 

<input type="hidden" name="roleName" value="@Model. 
Role.Name" /> 

<input type="hidden" name="roleId" value="@Model.Ro 
le.Id" /> 


<h6 class="bg-info p-1 text-white">Add To @Model.Ro 
le.Name</h6> 
<table class="table table-bordered table-sm"> 
@if (Model.NonMembers.Count() == 0) { 
<tr><td colspan="2">All Users Are Members</ 


td></tr> 
} else { 
@foreach (AppUser user in Model.NonMembers) 
{ 
<tr> 
<td>@user.UserName</td> 
<td> 


<input type="checkbox" name="Id 
SToAdd" value="@user.Id"> 
</td> 
</tr> 


} 
</table> 


<h6 class="bg-info p-1 text-white">Remove From @Mod 
el.Role.Name</h6> 
<table class="table table-bordered table-sm"> 
@if (Model.Members.Count() == @) { 
<tr><td colspan="2">No Users Are Members</t 
d></tr> 


} else { 
@foreach (AppUser user in Model.Members) { 
<tr> 
<td>@user.UserName</td> 
<td> 
<input type="checkbox" name="Id 
sToDelete" value="@user.Id"> 
</td> 
</tr> 
} 
} 
</table> 


<button type="submit" class="btn btn-primary">Save< 
/button> 


<a asp-action="Index" class="btn btn-secondary">Can 
cel</a> 
</form> 








Edit 视 图 中 包含 两 个 表格 : 一 个 用 于 不 是 所 选 
角色 成 员 的 用 户 ， 另 一 个 用 于 是 所 选 角色 成 员 的 用 
户 。 每 个 用 户 名 后 跟着 允许 修改 成 员 状 态 的 复 选 
框 。 两 个 表格 被 包含 在 将 发 送 到 Edit 操 作 方 法 的 表 
单 中 ， 数 据 将 被 绑 定 到 RoleModificationModel 类 ， 
从 而 可 以 轻松 地 访问 角色 成 员 的 变更 列表 。 














测试 和 编辑 角色 成 员 





为 了 测试 角色 成 员 ， 局 动 应 用 并 导航 到 URL 地 
址 /RoleAdmin。 如 采 需 要 ， 创 建 名 为 Users 的 新 角 
色 。 单 击 Edit 按 钮 ， 你 将 看 到 应 用 中 的 用 户 显示 为 
角色 的 非 成 员 用 户 ， 如 图 29-6 所 示 。 











图 29-6 ”显示 和 编辑 角色 成 员 


选中 复 选 框 以 添加 Alice 和 Joe (在 本 章 开始 的 
时 候 ， 这 两 个 账号 已 添加 到 ASP.NET Core Identity 
ARP) ， 然 后 单 击 Save 按 钮 。 在 角色 列表 中 ， 你 
将 看 到 Alice 和 Joe 现 在 位 于 角色 成 员 列 表 中 ， 如 图 
29-7 所 示 。 





3100edfd-8d39-4659-99bb-b228de16812b 


6bc34fc4-1627-4495-8067-481046528d96 








图 29-7 管理 角色 成 员 
29.3.3 ”使 用 角色 进行 授权 


示例 应 用 现在 有 了 角色， 它们 可 以 通过 
Authorize 特 性 作为 授权 的 基础 。 为 了 易于 测试 基于 
角色 的 授权 ， 在 Account 控 制 器 中 汪 加 Logout 操 作 方 
法 ， 如 代码 请 单 29-14 所 示 ， 这 将 允许 用 户 退 出 后 
以 男 一 个 用 户 的 映 份 重新 登录 并 僵 看 角色 成 员 的 效 
未 


代码 清单 29-14 在 Controllers 文 件 严 下 的 AccountController.cs 
文件 中 添加 Logout 操 作 方 法 





using System.Threading.Tasks ; 
using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Mvc; 


using Users.Models; 
using Microsoft.AspNetCore. Identity; 


namespace Users.Controllers { 
[Authorize ] 
public class AccountController : Controller { 
private UserManager<AppUser> userManager; 


private SignInManager<AppUser> signInManager ; 


// ...other action methods omitted for brevity. 


[Authorize] 

public async Task<IActionResult> Logout() { 
await signInManager .SignOutAsync(); 
return RedirectToAction("Index", "Home") ; 





2 ce Ft Homes till a5 CA DA ar BEET 
法 ， 并 将 认证 用 户 的 信息 传递 给 视图 ， 如 代码 清单 
29-15 所 示 。 


代码 清单 29-15 ”扩展 Controllers 文 件 夹 下 的 HomeController.cs 
文件 


using System.Collections.Generic; 
using Microsoft.AspNetCore.Mvc; 


using Microsoft.AspNetCore. Authorization; 
namespace Users.Controllers { 
public class HomeController : Controller { 


[Authorize | 
public IActionResult Index() => View(GetData(na 
meof (Index) ) ) ; 


[Authorize(Roles = "Users") ] 
public IActionResult OtherAction() => View("Ind 
ex", 
GetData(nameof(OtherAction) )); 
private Dictionary<string, object> GetData(stri 
ng actionName) => 
new Dictionary<string, object> { 
["Action"] = actionName, 
["User"] = HttpContext.User.Identity.Na 
me, 
["Authenticated"] = HttpContext.User.Id 
entity. IsAuthenticated, 
["Auth Type"] = HttpContext.User.Identi 
ty.AuthenticationType, 
["In Users Role"] = HttpContext.User.Is 
InRole("Users" ) 


}; 


} 





Index 操 作 方 法 的 Authorize 特 性 没有 变化 ， 但 
是 在 为 OtherAction 操 作 方 法 应 用 这 个 特性 时 设置 了 


Roles 属 性 ， 指 定 只 有 Users 角 色 的 成 员 可 以 访问 。 
这 里 还 定义 了 GetData 方 法 ， 以 返回 关于 用 户 标识 
的 一 些 基 本 信息 ， 可 使 用 HttpContext 对 象 的 属性 获 
取 这 些 信息 。 


人 
提示 


Authorize 特 性 也 可 以 基于 独立 用 户 名 的 列表 授 
权 访 问 。 对 于 小 项 目 来 说 ， 这 是 一 个 很 有 吸引 力 的 
特性 ， 但 是 这 意味 看 每 次 要 授权 的 用 户 友 生变 化 
时 ， 都 不 得 不 修改 控制 器 中 的 代码 ， 也 这 意味 着 不 
得 不 再 次 完成 测试 和 友 布 周期 。 使 用 角色 来 授权 可 
以 将 应 用 从 独立 账户 的 变化 中 隔离 出 来 ， 并 且 人 允许 
通过 存储 在 ASP.NET Core Identity 中 的 成 员 来 控制 





应 用 的 访问 。 


最 后 ， 修 改 Views/Home 文 件 夹 下 的 
Index.cshtml 文 件 ， 该 文件 由 Home 控 制 器 的 两 个 操 
作 方 法 使 用 。 琴 加 目标 为 Account 控 制 左 的 Logout 控 
作 的 链接 ， 如 代码 清单 29-16 所 示 。 


代码 清单 29-16 ”在 Views/Home 文 件 夹 下 的 Index.cshtml 文 件 中 
添加 退出 链接 





@model Dictionary<string, object> 


<div class="bg-primary m-1 p-1 text-white"><h4>User Det 
ails</h4></div> 


<table class="table table-sm table-bordered m-1 p-1"> 
@foreach (var kvp in Model) { 
<tr><tho@kvp.Key</th><td>@kvp.Value</td></tr> 


} 
</table> 


@if (User?.Identity?.IsAuthenticated ?? false) { 
<a asp-controller="Account" asp-action="Logout" 
class="btn btn-danger">Logout</a> 


为 了 测试 验证 ， 局 动 应 用 并 导航 
到 /Home/Index， 浏 览 句 将 被 重 定 阿 以 便 输 入 用 户 攒 
由 于 应 用 于 Index 操作 的 Authorize 特 性 允许 任何 
过 验证 的 用 户 访问 ， 因 此 从 表 29-2 中 选择 哪个 用 
户 进行 验证 显得 并 不 重要 。 














但 是 ， 如 果 访 问 URL 地 址 /Home/OtherAction， 

你 在 表 29-2 中 所 做 的 选择 就 会 导致 不 同 ， 因 为 只 有 
Alice 和 Joe 是 Users 角 色 的 成 员 ， 这 对 访问 
OtherAction 操 作 是 必需 的 。 如 果 以 Bob 用 户 身份 登 
录 ， 浏 览 器 将 被 重 定 同 到 /Account/AccessDenied， 

这 适用 于 当 用 户 不 能 访问 操作 方法 时 。 为 了 处 理 这 
种 情况 ， 这 里 在 Account 控 制 器 中 添加 
AccessDenied 操 作 ， 以 便 有 一 个 操作 可 以 处 理 这 种 
请 求 ， 如 代码 清单 29-17 所 示 。 
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设置 
IdentityOptions.Cookies.ApplicationCookie.AccessDen 
属性 ， 改 变 /Account /AccessDenied 地 址 。 


代码 清单 29-17 ”在 AccountController.cs 文 件 中 添加 操作 方法 





using System.Threading.Tasks; 

using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Mvc; 

using Users.Models; 

using Microsoft.AspNetCore.Identity; 


namespace Users.Controllers { 


[Authorize | 

public class AccountController : Controller { 
private UserManager<AppUser> userManager ; 
private SignInManager<AppUser> signInManager ; 


public AccountController(UserManager<AppUser> u 
serMgr, 


SignInManager<AppUser> signinMgr) { 
userManager = userMgr; 
SignInManager = signinMgr; 


} 


// ...other action methods omitted for brevity. 


[AllowAnonymous ] 


public IActionResult AccessDenied() { 
return View(); 








要 为 AccessDenied 操 作 提 供 视图 ， 可 在 
Views/Account 文 件 夹 中 创建 名 为 
AccessDenied.cshtml 的 文件 ， 然 后 汐 加 代码 清单 29- 
18 所 示 的 内 容 。 


代码 清单 29-18 Views/Account 文 件 夹 下 的 
AccessDenied.cshtml 文 件 的 内 容 


<div class="bg-danger mb-1 p-2 text-white"><h4>Access D 
enied</h4></div> 


<a asp-action="Index" asp-controller="Home" class="btn 
btn-primary" >OK</a> 





启动 应 用 并 访问 /Account/Login， 以 
bob@example.com 吴 份 登录 。 当 验证 过 程 完成 后 ， 
浏览 万 将 被 重 定 癌 到 /Home/Index， 这 将 旺 示 账户 的 
评 请 ， 如 图 29-8 左 边 的 截图 所 示 ， 这 表明 Bob 不 是 
Users 角 色 的 成 员 。 现 在 访问 /Home/OtherAction， 
Bob 不 是 所 要 求 角 色 的 成 员 ， 浏 览 器 被 重 定 同 到 
URL 地 址 /Account/AccessDenied， 如 图 29-8 右 边 的 
截图 所 示 。 








False 


fe ZN 

AICTE ALP SSRI IN, X ARE RK 
变 当前 已 登录 用 户 的 角色 ， 那 么 在 注销 和 重新 登录 
之 前 ， 更 改 不 会 生效 。 








29.4 播种 数据 库 


在 示例 项 目 中 ， 访 问 Admin 和 RoleAdmin 控 制 
器 是 不 受 限 制 的 。 需 要 创建 用 户 和 有 角色， 但 Admin 
和 RoleAdmin 控 制 右 是 用 户 官 理工 具 ， 如 末 使 用 
Authorize 特 性 保护 了 它们 ， 束 不 能 授权 任何 竺 据 来 
访问 它们 了 ， 特 别 是 在 第 一 次 部 普 应 用 之 前 。 











解决 方案 是 当 应 用 局 动 的 时 候 ， 使 用 一 些 初 始 
数据 来 播种 数据 库 。 如 代码 清单 29-19 所 示 ， 还 加 
一 些 新 的 配置 数据 到 appsettings.json 文 件 中 以 指定 





将 要 创建 的 账户 的 详情 。 
代码 清单 29-19 ”添加 配置 数据 到 appsettings.json 交 件 中 


{ 
"Data": { 
"AdminUser": { 

"Name": "Admin", 

"Email": "admin@example.com", 

"Password": "secret", 

"Role": "Admins" 

hs 
"SportStorelIdentity": { 

"ConnectionString": "Server=(localdb)\\MSSQLLocal 
DB;Database=IdentityUsers; Trusted Con 
nection=True;MultipleActiveResultSets=true" 

} 
} 


} 








Data: AdminUser 类 别提 供 了 创建 账户 需要 的 4 
个 值 ， 并 赋予 了 用 于 管理 工具 的 角色 。 
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并 第 一 次 初始 化 数据 时 ， 必 须 将 修改 默认 口令 作为 
部 着 过 程 的 一 部 分 。 





然后 ， 在 AppIdentityDbContext 类 中 添加 一 个 静 
态 方法 ， 如 代码 清单 29-20 所 示 。 创 建 默认 账户 的 


代码 不 需要 定义 在 这 个 类 中 ， 但 是 作者 把 它 用 在 了 
这 里 的 项 目 中 。 





代码 清单 29-20 在 Models 文 件 夹 下 的 AppIdentityDbContext.cs 
文件 中 添加 静态 方法 





using Microsoft.AspNetCore.Identity; 
using Microsoft.AspNetCore. Identity. EntityFrameworkCore 


3 

using Microsoft.EntityFrameworkCore; 

using Microsoft.Extensions.Configuration; 

using Microsoft.Extensions.DependencyInjection; 
using System; 


using System.Threading.Tasks ; 
namespace Users.Models { 


public class AppIdentityDbContext : IdentityDbConte 
xt<AppUser> { 


public AppIdentityDbContext (DbContextOptions<Ap 
pIdentityDbContext> options) 
: base(options) { } 


public static async Task CreateAdminAccount(ISe 
rviceProvider serviceProvider, 
IConfiguration configuration) { 


UserManager<AppUser> userManager = 
serviceProvider .GetRequiredService<User 
Manager<AppUser>>(); 
RoleManager<IdentityRole> roleManager = 
serviceProvider .GetRequiredService<Role 
Manager<IdentityRole>>(); 


string username = configuration[ "Data:Admin 
User :Name" ]; 

string email = configuration[ "Data: AdminUse 
r:Email"]; 

string password = configuration[ "Data:Admin 
User :Password" ]; 

string role = configuration["Data:AdminUser 


:Role"]; 
if (await userManager .FindByNameAsync(usern 
ame) == null) { 
if (await roleManager.FindByNameAsync(r 
ole) == null) { 


await roleManager.CreateAsync(new I 
dentityRole(role)); 


} 


AppUser user = new AppUser { 
UserName = username, 
Email = email 


}3 


IdentityResult result = await userManag 
er 
.CreateAsync(user, password) ; 
if (result.Succeeded) { 
await userManager.AddToRoleAsync(us 


er, role); 





CreateAdminAccount 方 法 接收 一 个 
IServiceProvider 对 象 ， 它 用 来 获取 UserManager、 
RoleManager 和 IConfiguration 对 象 ， 还 可 以 用 来 从 
appsetting.json 文 件 中 获取 数据 。 
CreateAdminAccount 方 法 中 的 代码 会 检查 用 户 是 否 
己 经 存在 ， 如 末 不 存在 ， 则 创建 用 户 并 赋予 指定 的 
角色 。 如 果 和 角色 也 不 存在 ， 束 创建 角色 。 代 码 清单 











29-21 在 Startup 类 中 添加 了 一 些 代 码 ， 可 在 设置 和 配 
置 应 用 之 后 调用 CreateAdminAccount 方 法 。 














代码 清单 29-21 在 Users 文 件 夹 下 的 Startup.cs 文 件 中 调用 数据 
库 方 法 


public void Configure(IApplicationBuilder app) { 
app.UseStatusCodePages() ; 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseAuthentication() ; 
app.UseMvcWithDefaultRoute() ; 
AppIdentityDbContext.CreateAdminAccount(app.Applica 
tionServices, 
Configuration) .Wait(); 


} 





由 于 正在 通过 
IApplicationBuilder.ApplicationServices 提 供 程序 来 
访问 受 限 的 服务 ， 因 此 还 必须 在 Program 类 中 禁用 
依赖 注入 范围 验证 特性 ， 如 代码 清单 29-22 所 示 。 


代码 清单 29-22 ”在 Users 文 件 夹 下 的 Program.cs 文 件 中 禁用 依 


赖 注入 范围 验证 特性 


using System; 

using System.Collections.Generic; 

using System. IO; 

using System. Linq; 

using System. Threading.Tasks; 

using Microsoft.AspNetCore; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.Extensions.Configuration; 
using Microsoft.Extensions.Logging; 


namespace Users { 
public class Program { 
public static void Main(string[] args) { 
BuildWebHost(args).Run(); 


} 


public static IWebHost BuildWebHost(string[] ar 


gs) => 
WebHost .CreateDefau1ltBuilder(args ) 
.UseStartup<Startup>() 
.UseDefaultServiceProvider(options => 
options.ValidateScopes = false) 
.Build(); 





现在 ，Identity 数 据 库 中 有 了 可 信 的 默认 账号 ， 
可 以 使 用 Authorize 特 性 来 保护 Admin 和 RoleAdmin 
控制 器 ， 代 码 清单 29-23 展 示 了 对 Admin 控 制 器 所 做 


的 修改 。 


代码 清单 29-23 ”在 Users 文 件 夹 下 的 AdminController.cs 文 件 中 
限制 访问 


using Microsoft .AspNetCore.Identity ; 
using Microsoft.AspNetCore.Mvc; 

using Users.Models; 

using System. Threading.Tasks; 

using Microsoft.AspNetCore. Authorization; 


namespace Users.Controllers { 


[Authorize(Roles = "Admins") ] 
public class AdminController : Controller { 


// ...statements omitted for brevity... 





As 29-2472 J TERoleAdmin44 fil] 48 FAT 
做 的 修改 。 


代码 清单 29-24 在 Controllers 文 件 夹 下 的 
RoleAdminController.cs 文 件 中 限制 访问 


using System.ComponentModel.DataAnnotations; 
using System. Threading. Tasks; 





using Microsoft .AspNetCore.Identity ; 
using Microsoft.AspNetCore.Mvc; 

using Users.Models; 

using System.Collections.Generic; 

using Microsoft.AspNetCore. Authorization; 


namespace Users.Controllers { 
[Authorize(Roles = "Admins") ] 
public class RoleAdminController : Controller { 
// ...statements omitted for brevity... 


} 





局 动 应 用 并 访问 URL 地 址 /Admin 
或 /RoleAdmin。 如 果 已 经 以 其 他 用 户 喘 份 登录 ， 则 
必须 先 注销 。 人 否则 ， 系 统 将 提醒 你 输入 凭据 ， 可 以 
使 用 账号 admin@example.com 和 和 密码 secret 进 行 验证 
以 访问 管理 功能 。 


29.5 小结 


本 章 展示 了 如 何 使 用 ASP.NET Core Identity 进 
行 验证 和 授权 ,说 明了 如 何 收集 和 验证 用 户 和 凭据 ， 
以 及 如 何 基于 用 户 所 属 的 角色 来 限制 对 操作 方法 的 


访问 。 下 一 章 将 演示 ASP.NET Core Identity 提 供 的 
局 级 特性 。 


第 30 章 ASP.NET Core Identity KY 


本 章 将 通过 展示 ASP.NET Core Identity 提 供 的 
一 些 高 级 特性 来 完成 对 ASP.NET Core Identity 的 介 
绍 ， 演 示 如 何 通 过 为 AppUser 类 上 和 定义 目 定 义 属 性 
来 扩展 数据 库 架 构 ， 以 及 如 何在 不 删除 ASP.NET 
Core Identity 数 据 库 中 数据 的 情况 下 使 用 数据 库 迁 
移 来 应 用 这 些 属 性 。 此 外 ， 本 章 还 将 说 明 ASP.NET 
Core Identity 如 何 文 持 声明 《claim) 的 概念 ， 并 展 
示 如 何 通 过 nein 
后 ， 本 章 通 过 展示 ASP.NET Core ed 
a 进行 映 份 验证 来 结束 本 章 。 可 使 用 
Google 账 户 来 演示 里 份 验证 ， 但 ASP.NET Core 
Identity 还 内 置 对 微软 、Facebook 和 Twitter 账户 的 文 
持 。 表 30-1 列 出 了 本 章 要 介绍 的 操作 。 

















表 30-1 本 章 要 介绍 的 操作 











































































































添加 属性 到 AppUser 类 ， 并 更 新 Identity 数 据 单 30-1 一 代码 清 
库 
































单 30-4 一 代码 清 










































































单 30-8 和 代码 清 






































创建 自 定 义 声明 ”| 使 用 声明 转换 









































使 用 声明 评估 用 三 : 单 30-10 一 代码 清 


























访问 




















单 30-15 一 代码 清 












































使 用 策略 访问 资源 | 评估 操作 方法 









































人 允许 使 月 接收 来 自 验 证 提供 器 的 声明 ， 比 如 微软 、 和 单 30-21 一 代码 清 
行 验证 Google 和 Facebook 



































30.1 准备 示例 项 目 


本 章 将 继续 使 用 你 在 第 28 章 创建 且 在 第 29 章 扩 


展 的 Users 项 目 。 局 动 应 用 并 确认 数据 库 中 己 经 有 一 
些 用 户 。 图 30-1 展 示 了 数据 库 的 状态 ， 其 中 包含 来 
和 目 上 一 章 的 用 户 Admin、Alice、Bob 和 Joe。 为 了 检 
答 这 些 用 户 ， 局 动 应 用 并 访问 /Admin， 以 Admin 
用 户 丑 份 进行 验证 ， 使 用 电子 邮件 地 址 


admin@example.com 和 密码 secret。 
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图 30-1 Identity 数据 库 中 的 初始 用 户 


本 章 还 需要 一 些 角色 。 导 航 到 /RoleAdmin， 然 
后 创建 名 为 Users 和 Employees 的 角色 并 为 这 些 角 色 
分 配 用 户 ， 如 表 30-2 所 示 。 


表 30-2 示例 应 用 要 求 的 角色 和 成 员 
[| 


成 员 


角色 
二 


图 30-2 展 示 了 RoleAdmin 控 制 器 的 必要 角色 配 
Ho 


psi 








所 C |O pc t 
ID Name Users 

3100edfd-8d39 -4659-99bb-b228de16812b Users Alice, Joe 
4b935f9b -804a-4f87-9426-67912e9789f2 Employees Alice, Bob 
6bc34fc4-1627-449 i ir 
= 














图 30-2 配置 本 章 要 求 的 角色 
30.2 ”添加 目 定 义 用 户 属 性 


在 第 28 章 ， 当 创建 AppUser 类 来 表示 用 户 的 时 
候 ， 基 类 定义 了 用 户 的 基本 属性 ， 比 如 电子 邮件 地 
址 和 电话 号 码 。 








大 多 数 应 用 程序 需要 保存 更 多 的 用 户 信息 ， 包 
括 持 和 久 化 的 应 用 程序 首选 项 和 详细 信息 ， 比 如 地 
址 。 简 而 言 之 ， 任 何 运 行 应 用 程序 有 用 且 在 会 话 之 

则 保留 的 数据 。 由 于 ASP.NET Core Identity 系 统 默 
认 使 用 Entity Framework Core 来 保存 数据 ， 因 此 定 
义 额外 的 用 户 信 息 意 味 着 为 AppUser 类 添加 属性 并 
使 用 Entity Framework Core 创 建 存储 它们 所 需 的 数 
据 库 模 式 。 














代码 清单 30-1 展 示 了 如 何 为 AppUser 类 这 加 两 
个 简单 属性 以 表示 用 户 生 活 的 城市 和 资格 等 级 。 


代码 清单 30-1 在 Models 文 件 夹 下 的 AppUser.cs 文 件 中 添加 局 
性 





using Microsoft.AspNetCore.Identity ; 


namespace Users.Models { 


public enum Cities { 
None, London, Paris, Chicago 


} 


public enum QualificationLevels { 
None, Basic, Advanced 
} 


public class AppUser : IdentityUser { 
public Cities City { get; set; } 
public QualificationLevels Qualifications { get 
; set; } 


} 





枚 举 Cities 和 QualificationLevels 定 义 了 用 于 城 
市 的 值 以 及 资格 水 平 的 不 同 级 别 。 这 些 枚 举 由 添加 
到 AppUser 类 的 City 和 Qualification 属 性 使 用 。 


在 代码 清单 30-2 中 ， 添 加 到 Home 控 制 右 的 操 
作 方 法 允许 用 户 查 看 和 编辑 它们 的 City 和 
Qualification 属 性 。 


代码 清单 30-2 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 件 
中 添加 对 上 自 定义 用 户 属 性 的 支持 





using System.Collections.Generic; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore. Authorization; 
using Users.Models; 


using Microsoft.AspNetCore.Identity; 
using System. Threading. Tasks; 
using System.ComponentModel .DataAnnotations ; 


namespace Users.Controllers { 
public class HomeController : Controller { 
private UserManager<AppUser> userManager ; 


public HomeController(UserManager<AppUser> user 


Mer) { 
userManager = userMgr; 


} 


[Authorize | 
public IActionResult Index() => View(GetData(na 
meof (Index))); 


[Authorize(Roles = "Users") ] 
public IActionResult OtherAction() => View("Ind 


ex", 
GetData(nameof(OtherAction))); 


private Dictionary<string, object> GetData(stri 
ng actionName) => 
new Dictionary<string, object> { 

["Action"] = actionName, 

["User"] = HttpContext.User.Identity.Na 
me, 

["Authenticated"] = HttpContext.User.Id 
entity. IsAuthenticated, 

["Auth Type"] = HttpContext.User.Identi 
ty.AuthenticationType, 

["In Users Role"] = HttpContext.User.Is 
InRole("Users"), 

["City"] = CurrentUser.Result.City, 

["Qualification"] = CurrentUser.Result. 


Qualifications 


ie 


[Authorize] 

public async Task<IActionResult> UserProps() { 
return View(await CurrentUser) ; 

} 


[Authorize] 
[HttpPost ] 
public async Task<IActionResult> UserProps( 
[Required]Cities city, 
[Required ]QualificationLevels qualifica 
tions) { 
if (ModelState.IsValid) { 
AppUser user = await CurrentUser; 
user.City = city; 
user.Qualifications = qualifications; 
await userManager .UpdateAsync(user) ; 
return RedirectToAction("Index" ) ; 
} 
return View(await CurrentUser) ; 


} 


private Task<AppUser> CurrentUser => 
userManager.FindByNameAsync(HttpContext.Use 
r.Identity.Name) ; 


} 


} 





新 的 CurrentUser 属 性 使 用 
UserManager<AppUser> 类 来 获取 表示 当前 用 户 的 





AppUser 实 例 。AppUser 实 例 可 作为 GET 版 本 的 
UserProps 操 作 方 法 的 视图 模型 ，POST 方 法 则 使 用 
它 来 更 新 City 和 QualificationLevel 属 性 的 值 。 


己 经 更 新 的 GetData 方 法 则 返回 包含 当前 用 户 
目 定义 属性 的 值 的 字典 ， 这 意味 着 这 些 属性 的 值 将 
在 Index 和 OtherAdction 操 作 方 法 的 视图 中 展示 出 
来 。 














为 了 给 UserProps 操 作 方 法 提供 视图 ， 在 
ViewsHome 文 件 夹 中 添加 名 为 UserProps.cshtml 的 
文件 ， 并 添加 代码 清单 30-3 所 示 的 标记 。 


代码 清单 30-3 ”Views/Home 文 件 夹 下 的 UserProps.cshtml 文 件 
的 内 容 





@model AppUser 


<div class="bg-primary m-1 p-1 text-white"><h4>@Model .U 
serName</h4></div> 


<div asp-validation-summary="All" class="text-danger">< 


/div> 


<form asp-action="UserProps" method="post"> 
<div class="form-group"> 
<label asp-for="City"></label> 
<select asp-for="City" class="form-control" 
asp-items="@new SelectList(Enum.GetName 
S(typeof(Cities)))"> 
<option disabled selected value= 
City</option> 
</select> 
</div> 
<div class="form-group"> 
<label asp-for="Qualifications"></label> 
<select asp-for="Qualifications" class="form-co 


>Select a 


ntrol" 
asp-items="@new SelectList(Enum.GetNames (ty 
peof (QualificationLevels) ))"> 
<option disabled selected value= 
ct a City</option> 
</select> 
</div> 


>Sele 


<button type="submit" class="btn btn-primary">Submi 
t</button> 

<a asp-action="Index" class="btn btn-secondary">Can 
cel</a> 
</form> 





UserProps 视 图 包含 一 个 具有 select 元 素 的 表 
单 ， 其 中 填充 了 代码 清单 30-1 中 的 枚 举 值 。 当 表单 
被 提交 时 ， 从 ASP.NET Core Identity 中 获取 表示 当 








前 用 户 的 AppUser 实 例 ， 用 户 的 目 定 义 属性 的 值 被 
更 新 为 当前 选中 的 值 ， 如 下 所 示 : 


AppUser user = await CurrentUser ; 
user.City = city; 
user .Qualifications = qualifications; 


await userManager.UpdateAsync(user) ; 
return RedirectToAction("Index") ; 





注意 ， 必 须 通 过 调用 UpdateAsync 方 法 显 式 地 
告诉 用 户 管理 器 为 用 户 更 新 数据 库 记 录 以 反映 更 
新 。 以 前 不 必 这 样 做 是 因为 在 更 新 ASP.NET Core 
Identity 的 方法 中 已 经 调用 了 UpdateAsync 方 法 ， 但 
是 当 直 接 修改 属性 时 ， 你 有 员 任 通知 用 户 官 理 占 执 
行 更 新 。 





30.2.1 准备 数据 库 迁 移 


用 以 支持 新 增 属 性 的 所 有 应 用 内 部 文 持 已 经 束 
绕 ， 剩 下 的 束 古 更 新 数据 库 ， 以 便 其 中 的 数据 表 可 





以 存储 目 定义 属性 的 值 。 


Entity Framework Core 没 有 对 处 理 种 子 数据 提 
供 集成 文 持 ， 在 创建 迁移 以 茶 用 种 子 的 时 候 必须 小 
心 ， 如 代码 清单 30-4 所 示 ;， 否则， 代码 清单 30-1 中 
新 还 加 到 模型 类 的 属性 将 会 导致 错误 。 种 子 语句 可 
以 在 创建 和 应 用 数据 库 迁 移 之 后 再 次 启用 。 











代码 清单 30-4 在 Users 文 件 夹 下 的 Startup.cs 文 件 禁 用 数据 库 播 
种 


public void Configure(IApplicationBuilder app) { 
app.UseStatusCodePages() ; 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseAuthentication() ; 
app.UseMvcWithDefaultRoute() ; 
// AppIdentityDbContext.CreateAdminAccount(app.A 
pplicationServices, 
// Configuration) .Wait(); 





} 





在 蔡 用 种 子 语句 的 情况 下 ， 下 一 步 是 创建 新 的 


数据 库 迁 移 文件 ， 其 中 包含 用 来 更 新 数据 库 架 构 的 
SQL 命 令 。 使 用 命令 行 窗 口 或 PowerShell 窗 口 在 
Users 项 目 文 件 夹 中 执行 如 下 命令 : 


dotnet ef migrations add CustomProperties 


当 命 令 完 成 的 时 候 ， 你 将 会 在 Migrations 文 件 
夹 中 发 现 一 个 名 称 中 含有 CustomProperties 的 新 文 
件 。 确 切 的 名 称 中 还 包含 数字 标识 ， 但 是 如 采 打 开 
这 个 文件 ， 你 将 会 发 现 一 个 包含 名 为 Up 的 方法 的 
C# 关 ，Up 方 法 执行 为 文 持 癌 数 据 库 添 加 目 定 义 属 
性 所 需 的 SQL 命令 。 另 外 一 个 名 为 Down 的 方法 用 
于 执行 将 数据 库 降 级 到 上 一 个 模式 的 命令 。 





下 一 步 是 迁移 数据 库 到 新 的 模式 ， 可 通过 执行 
LB ar eX: 


dotnet ef database update 


当 命 令 执 行 守 之后， 数据 库 中 存储 用 户 数据 的 
表 将 包含 新 的 表示 目 定 义 属 性 的 列 。 


1k 
OF 


FEAL RK HP BOR UT m BGR Fe EAT BU 
库 迁 移 时 ， 务 必 小 心 。 创 建 包 含 删 除 列 或 整个 表 的 
迁移 非常 容易 ， 这 可 能 导致 又 灭 性 的 影响 。 确 保 彻 
发 测试 数据 库 迁 移 的 有 影响， 确保 备份 天 键 数据 以 防 
万 一 


30.2.2 ”测试 目 定 义 属 性 


要 测试 数据 库 迁 移 的 影响 ， 可 局 动 应 用 程序 ， 
并 使 用 已 标识 的 用 户 之 一 进行 验证 例如， 使 用 电 
子 邮 件 地 址 alice@example.com 和 密码 secret123) 。 
一 旦 验证 通过 ， 你 将 会 看 到 City 和 QualificationLevel 
属性 的 默认 值 。 这 两 个 属性 可 以 通过 访 
问 /Home/UserProps 进 行 修改 ， 选 择 新 的 值 ， 单 击 
Submit 控 钮 ， 这 将 会 更 新 数据 库 并 重 定 问 
到 /Home， 这 里 将 显示 新 的 值 ， 如 图 30-3 所 示 。 








图 30-3 ”使 用 自 定 义 用 户 属 性 


30.3 ”使 用 声明 和 案 略 


较 早 的 用 户 管理 系统 (比如 ASP.NET 


Membership) 是 ASP.NET Core IdentityH #4, DY 
用 程序 本 里 假定 自己 是 所 有 用 户 信 息 的 权威 来 源 ， 
基本 上 把 应 用 看 作 封 闭 的 世界 ， 只 信任 应 用 自 里 的 
数据 。 

















这 是 软件 开发 中 很 久远 的 处 理 方式 。 在 第 29 章 
中 ， 当 基于 保存 在 数据 库 中 的 攒 据 验 证 用 户 ， 然 后 
基于 这 些 凭据 授权 访问 时 ， 你 已 经 看 到 了 一 些 示 
例 。 在 本 章 中 ， 当 添加 属性 到 AppUser 类 的 时 候 ， 
可 以 做 同样 的 事情 。 管 理 用 户 的 验证 和 授权 所 需 的 
任何 信息 都 来 自 应 用 。 对 于 许多 Web 应 用 来 襄 ， 这 
是 一 种 完美 的 方式 ， 这 也 是 本 章 如 此 深入 地 演示 这 
些 技术 的 原因 。 








ASP.NET Core Identity 还 文 持 另外 一 种 管理 用 
户 的 蔡 代 方式 一 一 使 用 声明 ， 当 MVC 应 用 程序 并 不 
是 用 户 信息 的 唯一 来 源 时 同样 工作 恨 好 ， 相 对 于 传 
统 方式 ， 以 更 加 灵活 、 流 畅 的 方式 授权 用 户 。 








cr 


提 示 


并 一 定 需 要 使 用 声明 ， 如 第 29 章 所 述 ， 
ASP.NET Core Identity 完 美 提 供 了 验证 和 授权 服 


务 ， 完全 不 需要 理解 声明 。 





30.3.1 声明 








声明 是 关于 用 户 的 一 段 信 息 ， 它 还 包括 关于 信 
恩 来 源 的 信息 。 理 解 声明 的 最 简单 方式 是 进行 一 些 
实际 的 演示 ， 人 奋 则 任何 讨论 都 太 过 抽象 而 无 用 。 为 
了 开始 演示 ， 在 Controllers 文 件 夹 中 添加 名 为 
ClaimsController.cs 的 美文 件 ， 并 用 它 定 义 代码 清单 





30-5 TAN HIF ill A o 


or 


提 示 


你 可 能 对 这 个 示例 中 的 代码 和 类 感到 一 点 迷 
惑 。 现 在 不 必 担 心细 市 ， 只 要 坚持 下 去 ， 和 直人 至 看 到 
操作 方法 和 定义 的 视图 的 输出 。 重 要 的 是 ， 这 将 有 
助 于 理解 声明 。 


代码 清单 30-5 Controllers ¢ 43% F HJ ClaimsController.cs 4# 
的 内 容 





using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Mvc; 


namespace Users.Controllers { 


public class ClaimsController : Controller { 


[Authorize] 
public ViewResult Index() => View(User?.Claims) 








可 以 通过 多 种 途径 来 获取 用 户 相 关 的 声明 。 
User 属 性 (也 可 以 通过 HttpContext.User 属 性 ) 返回 
一 个 ClaimsPrincipal 对 象 ， 这 也 是 这 个 示例 中 使 用 
的 方式 。 关 联 a 到 用 户 的 声明 集合 可 通过 
ClaimsPrincipal 类 访问 ， 该 类 的 重要 成 员 如 表 30-3 所 
Tne 











表 30-3 ”ClaimsPrincipal 类 的 重要 成 员 


描述 


获取 关联 到 当前 用 户 的 IIdentity 


FindAll(type) 


返回 特定 类 型 或 匹配 条 件 谓词 的 声明 
FindAll(<predicate>) 











回 第 一 个 特定 类 型 或 匹配 条 件 谓词 的 声明 


= 


FindFirst(type) 








FindFirst(<predicate>) 























HasClaim(type,value) | 如 果 用 户 拥 有 特定 声明 类 型 的 特定 值 ， 或 者 拥有 匹配 条 件 谓 词 的 声 






































HasClaim(<predicate>) | 明 ， 就 返回 true 





























VPA, we 


如 第 28 章 所 述 ，HttpContext.User.Identity 属 性 
将 返回 一 个 实现 了 Identity 接 口 的 对 象 ， 在 
ASP.NET Core Identity 中 是 ClaimsIdentity 对 象 。 表 
30-4 展 示 了 定义 在 ClaimsIdentity 类 中 的 重要 成 员 。 








表 30-4 定义 在 ClaimsIdentity 类 中 的 重要 成 员 


回 表 示 用 户 声 明 的 Claim 对 象 的 枚 举 


为 用 户 标识 添加 声明 
































为 用 户 标 识 添加 























HasClaim(predicate) 户 标 识 包含 还 配 特定 谓词 的 声明 ， 




















RemoveClaim(claim) 从 用 户 标识 中 删除 声明 





还 有 其 他 的 方法 和 属性 可 用 ， 但 是 表 30-4 中 的 


这 些 经 常用 于 Web 应 用 ， 原 因 显 而 易 见 ， 它 们 演示 
了 声明 〈Claim ) 如 何 适 用 于 广泛 的 ASP.NET Core 
+t 





代码 清单 30-5 使 用 Controller.User 属 性 来 获取 
ClaimsPrincipal 对 象 并 传递 Claims 属 性 值 作为 视图 模 
型 给 默认 视图 。Cliam 对 象 表 示 关 于 用 户 的 单 厂 数 
据 ，Claim 关 定义 的 属性 如 表 30-5 所 示 。 








表 30-5 Claim% Œ X H3 JETE 



































返回 提供 声明 的 系统 的 名 称 

















返回 声明 所 表示 用 户 的 ClaimsIdentity 对 象 














返回 声明 所 表示 的 信息 类 型 

















回声 明 所 表示 的 信息 片段 


加 


Value 











为 了 显示 用 户 所 关联 声明 的 详情 ， 创 建 
Views/Claims 文 件 来， 在 其 中 创建 名 为 Index.cshtml 
的 文件 ， 并 添加 代码 清单 30-6 所 示 的 标记 内 容 。 





代码 清单 30-6 Views/Claims 文 件 夹 下 的 Index.cshtml 文 件 的 内 


IP 


谷 





@model IEnumerable<System.Security.Claims.Claim> 


<div class="bg-primary m-1 p-1 text-white"><h4>Claims</ 
h4></div> 


<table class="table table-sm table-bordered"> 
<tr> 
<th>Subject</th><th>Issuer</th><th>Type</th><th 
>Value</th> 
</tr> 
@if (Model == null || Model.Count() == @) { 
<tr><td colspan="4" class="text-center">No Clai 
ms</td></tr> 
} else { 
@foreach (var claim in Model.OrderBy(x => x.Typ 
e)) { 
<tr> 
<td>@claim.Subject.Name</td> 
<td>@claim.Issuer</td> 
<td identity-claim-type="@claim.Type">< 


/七 d> 
<td>@claim.Value</td> 
</tr> 
} 
} 


</table> 








Index 视 图 使 用 表格 来 显示 视图 模型 中 提供 的 
每 个 声明 。Claim.Type 属 性 是 用 于 微软 架构 的 
URI， 不 是 特别 有 用 。 和 常用 的 架构 可 作为 
System.Security.Claims.ClaimTypes 的 字段 值 ， 所 以 
为 了 使 ndex 视 图 的 输出 更 易 谈 ， 可 还 加 自 定 义 属性 
到 td 元 素 以 显示 Type 属性 的 值 : 











<td identity-claim-type="@claim.Type"></td> 





添加 名 为 ClaimTypeTagHelper.cs 的 类 文件 到 
Infrastructure 文 件 夹 中 ， 并 用 它 创 建 标记 助手 以 转 
换 属 性 的 值 到 更 易 读 的 字符 串 中 ， 如 代码 清单 30-7 
所 示 。 








代码 清单 30-7 Infrastructure 文件 夹 下 的 ClaimTypeTagHelper.cs 
文件 的 内 容 





using System.Ling; 

using System.Reflection; 

using System.Security.Claims ; 

using Microsoft.AspNetCore. Razor. TagHelpers; 


namespace Users.Infrastructure { 


[HtmlTargetElement("td", Attributes = "identity-cla 
im-type") ] 
public class ClaimTypeTagHelper : TagHelper { 
[HtmlAttributeName("identity-claim-type") ] 
public string ClaimType { get; set; } 


public override void Process(TagHelperContext c 
ontext, 
TagHelperOutput ou 
tput) { 
bool foundType = false; 
FieldiInfo[] fields = typeof(ClaimTypes).Get 
Fields(); 
foreach (FieldInfo field in fields) { 
if (field.GetValue(null).ToString() == 
ClaimType) { 
output.Content.SetContent(field.Nam 
e); 
foundType = true; 
} 
} 
if (!foundType) { 
output.Content.SetContent(ClaimType.Spl 
it('/', '.').Last()); 





要 了 人 解 为 什么 只 创建 使 用 声明 的 控制 问 而 不 解 
释 声 明 是 什么 ， 可 局 动 应 用 程序 ， 以 用 户 Alice 的 号 
份 进行 验证 《使 用 电子 邮件 地 址 alice@example.com 
以 及 密码 secret123) 。 一 旦 通过 验证 ， 就 访 
问 /Claims 来 查看 用 户 关 联 的 声明 ， 如 图 30-4 所 示 。 


e © D localhost a 2 
Claoms 
ubject Issuer Value 
Ji 


图 30-4 ”Claims 控 制 器 的 Index 操 作 的 输出 


通过 图 30-4 你 很 难 弄 清楚 细节 ， 所 以 这 里 重 写 
了 表 30-6 所 示 的 内 容 。 


表 30-6 ”图 30-4 中 展示 的 内 容 





表 30-6 展 示 了 声明 的 一 些 重要 方面 ， 第 29 章 在 
实现 传统 的 吴 份 验证 与 授权 功能 时 ， 已 经 使 用 过 筷 
们 。 可 以 看 到 某 些 声 明 涉 及 用 户 标 识 (Name 声 明 
是 Alice，Nameldentifier 声 明 是 Alice 在 ASP.NET 
Core Identity 数 据 库 中 的 唯一 用 户 标 识 ) 。 其 他 声 
明 展 示 了 角色 成 员 ， 表 30-6 中 有 两 个 角色 声明 ， 反 
HR F Alice $x Iih Y Users #llEmployees fA 6 











当 这 些 信息 被 表示 为 一 组 声明 时 ， 区 别 在 于 可 








以 确定 数据 的 来 源 。 表 30-6 中 所 有 声明 的 Issuer 属 性 
都 被 设置 为 LOCAL AUTHORITY， 这 表示 用 户 的 
号 份 由 应 用 程序 建立 。 


现在 你 已 经 看 到 一 些 示 例 声明 ， 可 以 更 容易 地 
描述 声明 了 : 声明 是 任何 关于 用 户 的 可 用 于 应 用 程 
序 的 信息 ， 包 括 用 户 的 标识 和 角色 成 员 资格 ， 并 且 
如 你 所 见 ， 在 早期 章节 中 定义 的 关于 用 户 的 信息 由 
ASP.NET Core Identity 自 动 提供 。 虽 然 一 开始 声明 
令 人 困惑 ， 但 是 如 同 MVC 应 用 程序 的 其 他 方面 一 
样 ， 一 旦 看 清 它 们 是 如 何 工 作 的 ， 它 们 就 变 得 不 那 
么 困难 了 。 














30.3.2 ”创建 声明 


意思 的 是 ， 可 以 从 多 种 来 源 获 取 声 明 ， 而 不 
仅仅 依赖 本 地 数据 库 中 的 用 户 信息 。30.4 贡 会 演示 
实际 的 示例 ， 但 是 此 刻 将 通过 湛 加 一 个 类 到 示例 项 





目 中 来 模拟 提供 声明 信息 的 系统 。 人 代码 清单 30-8 展 
示 了 添加 到 Infrastructure 文件 夹 的 
LocationClaimsProvider.cs 文 件 的 内 容 。 


代码 清单 30-8 ”Infrastructure 文 件 夹 下 的 
LocationClaimsProvider.cs 文 件 的 内 容 





using System.Security.Claims; 
using System.Threading.Tasks; 
using Microsoft.AspNetCore.Authentication; 


namespace Users.Infrastructure { 


public class LocationClaimsProvider : IClaimsTransf 
ormation { 


public Task<ClaimsPrincipal> TransformAsync(Cla 
imsPrincipal principal) { 
if (principal != null && !principal.HasClai 
m(c => 
c.Type == ClaimTypes.PostalCode)) { 
ClaimsIdentity identity = principal.Ide 
ntity as ClaimsIdentity; 
if (identity != null && identity.IsAuth 
enticated 
&& identity.Name != null) { 
if (identity.Name.ToLower() == "ali 


ce") { 
í 


identity.AddClaims(new Claim[] 


CreateClaim(ClaimTypes.Post 
alCode, "DC 20500"), 
CreateClaim(ClaimTypes.Stat 
eOrProvince, "DC") 
})3 
} else { 
identity .AddClaims(new Claim[] 
{ 


alCode, "NY 10036"), 


CreateClaim(ClaimTypes.Post 


CreateClaim(ClaimTypes.Stat 
eOrProvince, "NY") 


})s 
} 


return Task.FromResult(principal) ; 


} 


private static Claim CreateClaim(string type, s 
tring value) => 
new Claim(type, value, ClaimValueTypes.Stri 
ng, "RemoteClaims") ; 


} 


} 





由 接口 IClaimsTransformation 定 义 的 
TransformAsync 方 法 接收 ClaimsPrincipal 对 象 并 检查 
有 效 性 ， 然 后 将 Identity 属 性 的 值 转型 为 
ClaimsIdentity 对 象 。Name 属 性 的 值 用 于 创建 关于 


用 户 邮 编 和 州 的 声明 。 


这 个 类 能 够 模拟 中 心 化 的 HR 数据 库 系 统 ， 作 
为 员工 位 置信 息 的 权威 来 源 。 例 如 ， 为 注册 声明 的 
来 源 ， 可 在 Startup 类 的 ConfigureServices 方 法 中 定 
义 来 源 ， 如 代码 清单 30-9 所 示 。 








代码 清单 30-9 ”在 Users 文 件 夹 下 的 Startup.cs 文 件 中 启用 声明 转 


换 





using 
using 
using 
using 
using 
using 
using 
using 


Microsoft.AspNetCore. Builder; 
Microsoft.Extensions.DependencyInjection; 
Microsoft.Extensions.Configuration; 
Microsoft.AspNetCore.Identity; 

Microsoft. EntityFrameworkCore; 
Users.Models; 

Users.Infrastructure; 
Microsoft.AspNetCore. Authentication; 


namespace Users { 


public class Startup { 


public Startup(IConfiguration configuration) => 
Configuration = configuration; 


public IConfiguration Configuration { get; } 


public void ConfigureServices(IServiceCollectio 
n services) { 


services.AddTransient<IPasswordValidator<Ap 
pUser>, 
CustomPasswordValidator>(); 
services.AddTransient<IUserValidator<AppUse 
r>, 
CustomUserValidator>() ; 
services.AddSingleton<IClaimsTransformation, 


LocationClaimsProvider>() ; 


services .AddDbContext<AppIdentityDbContext> 
(options => 
options.UseSqlServer ( 
Configuration[ "Data:SportStoreIdent 
ity: ConnectionString"])); 


services.AddIdentity<AppUser, IdentityRole> 
(opts => { 
opts.User.RequireUniqueEmail = true; 
//opts.User.AllowedUserNameCharacters = 
“abcdefghijklmnopgrstuvwxyz" ; 
opts.Password.RequiredLength = 6; 
opts.Password.RequireNonAlphanumeric = 


false; 
opts.Password.RequireLowercase = false; 
opts.Password.RequireUppercase = false; 
opts.Password.RequireDigit = false; 
}) .AddEntityFrameworkStores<AppIdentityDbCo 
ntext>() 


.AddDefaultTokenProviders() ; 


services.AddMvc(); 


public void Configure(IApplicationBuilder app) 


app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseAuthentication() ; 
app.UseMvcWithDefaultRoute() ; 








每 当 一 个 请 求 补 接收 时 ， 声 明 转 换 中 间 件 就 调 
用 LocationClaimsProvider.AddClaims 方 法 ， 模 拟 HR 
数据 源 并 创建 自 定义 声明 。 可 以 通过 局 动 应 用 程 
序 ， 以 用 户 号 份 验证 ， 然 后 访问 /Claim 来 僵 看 自 定 
义 声明 的 效 末 。 图 30-5 展 示 了 Alice 的 声明 。 你 可 能 
需要 先 注销 再 重新 登录 才能 得 看 变化 。 


[M Users 
é CO localhost54928/C wl: 


Subject Issuer Type Value 


Alice LOCAL AUTHORITY SecurityStamp 27da3494-9d75-41ce-a4f5-3958f4f19450 














图 30-5 “为 用 户 定 义 额外 的 声明 





从 多 个 位 置 获取 声明 意味 着 应 用 程序 不 必 重 复 
在 其 他 地 方 已 经 持 有 的 数据 ， 并 允许 集成 外 部 数 
据 。Claim.Issuer 属 性 指出 声明 来 自 何 方 ， 这 有 助 于 
判断 数据 的 准确 程度 ， 以 及 在 应 用 程序 中 赋予 的 权 
重 。 从 中 心 化 的 HR 数据 库 中 获取 的 位 置信 息 可 能 
比 从 外 部 邮件 列表 供应 商 获 取 的 数据 更 准确 和 可 


-ES 
[ 


AE o 


创建 目 定 义 的 标识 声明 


如 果 希 望 回 应 用 程序 添加 上 自 定义 的 本 地 声明 ， 
可 以 在 创建 痢 用 户 时 执行 此 操作 。UserManager<T> 
类 提供 了 可 用 于 定义 本 地 声明 的 AddClaimAsync 和 
AddClaimsAsync 方 法 ， 随 后 声明 会 存储 在 数据 库 
中 ， 并 在 用 户 被 验证 时 目 动 提取 《这 意味 痢 不 需要 


依赖 与 声明 转换 特性 ) 。 但 是 ， 在 使 用 这 些 方法 之 
前 ， 请 考虑 如 何 将 数据 存储 在 最 新 状态 ， 以 及 如 何 
从 数据 源 中 动态 检索 数据 以 更 好 地 服务 于 应 用 程 

序 。 声 明 用 于 授权 检查 ， 而 陈旧 的 声明 数据 允许 用 
户 访问 本 应 该 被 茶 止 访问 的 应 用 程序 区 域 ， 并 阻止 
已 经 个 授 权 访 问 的 应 用 程序 区 域 。 








30.3.3 (EH 





一 旦 一 些 声 明 可 用 ， 束 可 以 用 相 比 标准 角色 更 
为 灵活 的 方式 来 管理 用 户 对 应 用 程序 的 访问 。 和 角色 
的 问题 在 于 它们 是 静态 的 ， 一 旦 用 户 被 分 配 到 角 
色 ， 用 户 瓯 保持 成 员 直 到 角色 被 显 陈 移 除 。 例 如 ， 
大 公司 中 的 长 期 雇员 最 终 获 得 内 部 系统 难以 置信 的 
访问 权限 的 原因 ， 葡 在 于 他 们 被 赋予 每 个 新 职位 所 
需 的 角色 ， 但 是 旧 的 角色 很 少 被 删除 。 











声明 用 于 构建 授权 人 策略， 它们 是 应 用 程序 配置 
的 一 部 分 ， 并 将 Authorize 特 性 应 用 于 操作 方法 或 控 
制 妖 。 代 码 清单 30-10 展 示 的 简单 集 略 只 允许 拥有 
特定 声明 类 型 和 值 的 用 户 访问 。 





代码 清单 30-10 ”在 Users 文 件 夹 下 的 Startup.cs 文 件 中 创建 声明 
策略 





using Microsoft.AspNetCore. Builder; 

using Microsoft.Extensions.DependencyInjection; 
using Microsoft.Extensions.Configuration; 

using Microsoft.AspNetCore.Identity; 

using Microsoft. EntityFrameworkCore; 

using Users.Models; 

using Users.Infrastructure; 

using Microsoft.AspNetCore.Authentication; 
using System.Security.Claims; 


namespace Users { 
public class Startup { 


public Startup(IConfiguration configuration) => 
Configuration = configuration; 


public IConfiguration Configuration { get; } 


public void ConfigureServices(IServiceCollectio 
n services) { 


services.AddTransient<IPasswordValidator<Ap 
pUser>, 
CustomPasswordValidator>(); 
services.AddTransient<IUserValidator<AppUse 
r>, 
CustomUserValidator>() ; 
services.AddSingleton<IClaimsTransformation 
， LocationClaimsProvider>(); 


services.AddAuthorization(opts => { 
opts.AddPolicy("DCUsers", policy => { 
policy.RequireRole("Users") ; 
policy.RequireClaim(ClaimTypes.Stat 
eOrProvince, "DC"); 
}); 
}); 


services .AddDbContext<AppIdentityDbContext> 
(options => 
options.UseSqlServer ( 
Configuration[ "Data:SportStoreIdent 
ity:ConnectionString"])); 
services.AddIdentity<AppUser, IdentityRole> 
(opts => { 
opts.User.RequireUniqueEmail = true; 
//opts.User.AllowedUserNameCharacters = 
"abcdefghijklmnopgqrstuvwxyz" ; 
opts.Password.RequiredLength = 6; 
opts.Password.RequireNonAlphanumeric = 
false; 
opts.Password.RequireLowercase = false; 
opts.Password.RequireUppercase = false; 
opts.Password.RequireDigit = false; 
}) .AddEntityFrameworkStores<AppIdentityDbCo 
ntext>() 


.AddDefaultTokenProviders(); 


services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app) 


app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseAuthentication() ; 
app.UseMvcWithDefaultRoute() ; 








AddAuthorization 方 法 用 于 设置 授权 策略 并 提 
4 AuthorizationOptions*t 4, AuthorizationOption2& 
定义 的 成 员 如 表 30-7 所 示 。 


表 30-7 AuthorizationOptions 类 定义 的 成 员 












































默认 的 授权 策略 ， 用 于 在 没有 使 用 任何 参数 的 情况 下 使 用 
Authorize 特 性 时 。 默 认 情 况 下 ， 检 查 用 户 是 否 已 经 被 验证 


AddPolicy(name,expression) | 用 

















DefaultPolicy 















































策略 是 使 用 AddPolicy 方 法 定义 的 ， 可 在 
AuthorizationPolicyBuilder 对 象 上 使 用 表 30-8 摘 述 的 
方法 逐步 构建 策略 。 





表 30-8 ”AuthorizationPolicyBuilder 类 定义 的 成 员 方法 


RequireAuthenticatedUser() 要 求 请 求 关联 于 已 验证 的 用 户 


























RequireUserName(name) 要 求 请 求 关联 于 特定 用 广 








要 求 用户 拥 有 特定 类 型 的 声明 。 只 要 求 特定 类 型 的 声明 存 
在 ， 声 明 的 任何 值 都 可 以 接收 





RequireClaim(type) 
































要 求 用 户 拥有 特定 类 型 的 声明 ， 且 拥有 特定 范围 内 的 某 个 
RequireClaim(type,values) 值 。 值 可 以 表示 为 使 用 逗号 分 隔 的 参数 ， 或 是 


IEnumerable<string > 类 型 值 





















































要 求 用 户 是 角色 的 成 员 。 多 个 角色 可 以 使 用 逗号 分 隔 的 参 
RequireRole(roles) 数 或 IEnumerable<string > 表示 ， 任 何 角色 的 成 员 都 可 以 满足 


要 求 


AddRequirements(requirement) | 用 于 添加 自 定 义 的 需求 到 策略 中 












































代码 清单 30-10 中 的 策略 要 求 用 户 拥 有 Users 角 
色 以 及 带 DC 值 的 StateOrProvince 声 明 。 当 有 多 个 要 
求 时 ， 必 须 满足 所 有 的 要 求 才能 授权 。 








AddPolicy 方 法 的 第 一 个 参数 是 应 用 策略 时 引 
用 的 束 略 名 称 。 在 代码 消音 30-10 中 ， 集 略 的 名 称 
是 DCUsers。 在 代码 清单 30-11 中 ， 这 个 名 称 由 
Home 控 制 句 中 的 Authorize 特 性 使 用 以 应 用 策略 。 


代码 清单 30-11 在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 应 用 授权 策略 








using System.Collections.Generic; 

using Microsoft.AspNetCore.Mvc; 

using Microsoft.AspNetCore. Authorization; 
using Users.Models; 

using Microsoft.AspNetCore. Identity; 

using System. Threading. Tasks; 

using System.ComponentModel.DataAnnotations; 


namespace Users.Controllers { 


public class HomeController : Controller { 
private UserManager<AppUser> userManager; 


public HomeController(UserManager<AppUser> user 


Mgr) { 
userManager = userMgr; 


} 


[Authorize] 

public IActionResult Index() => View(GetData(na 
meof(Index))); 

//[Authorize(Roles = "Users") ] 

[Authorize(Policy = "DCUsers") ] 

public IActionResult OtherAction() => View("Ind 


GetData(nameof(OtherAction) )); 
// ...other methods omitted for brevity... 
private Task<AppUser> CurrentUser => 


userManager .FindByNameAsync(HttpContext.Use 
r.Identity.Name) ; 


} 


} 





Policy 属 性 用 于 指定 将 用 于 保护 操作 方法 的 策 
略 名 称 。 结 有 末 就 是 当 请 求 针 对 OtherAction 方法 时 ， 
将 对 用 户 拥有 的 角色 和 声明 进行 组 合 检 查 。 只 有 在 
Alice 拥 有 和 角色 成 员 和 声明 的 正确 组 合 时 ， 才 可 以 通 
过 运行 应 用 程序 进行 检查 ， 以 不 同 的 身份 进行 验 
证 ， 并 访问 /Home/OtherAction。 











创建 目 定义 的 策略 需求 





内 置 的 策略 需求 会 检查 特定 的 值 ， 这 是 很 好 的 
起 点 ， 但 是 并 不 能 anna: aan 
EERW 4 RAIL, ISAS A 
手 ， 内 置 的 策略 需求 不 是 为 应 对 这 种 检查 而 建立 

的 。 























圣 运 的 是 ， 可 以 通过 上 自 定 义 需 求 来 扩展 策略 系 
统 ， 它 们 是 实现 了 接口 I[AuthorizationRequirement 并 
目 定义 授权 处 理 的 类 ， 也 是 评估 给 定 请 求 的 需求 的 
AuthorizationHandler 类 的 子 类 。 为 了 演示 ， 在 
Infrastructure XF R PUSAN 
BlockUsersRequirement.cs 的 类 文件 ， 如 代码 清单 30- 
12 所 示 ， 用 它 定 义 目 定义 需求 和 处 理 程序 。 














代码 清单 30-12 Infrastructure CE SE FAY 
BlockUsersRequirement.cs 文 件 的 内 容 





using System; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Authorization; 


namespace Users.Infrastructure { 


public class BlockUsersRequirement : IAuthorization 
Requirement { 


public BlockUsersRequirement(params string[] us 
ers) { 
BlockedUsers = users; 


} 


public string[] BlockedUsers { get; set; } 
} 


public class BlockUsersHandler : AuthorizationHandl 
er<BlockUsersRequirement> { 


protected override Task HandleRequirementAsync( 
AuthorizationHandlerContext context, 
BlockUsersRequirement requirement) { 
if (context.User.Identity != null && contex 
t.User.Identity.Name != null 
&& !requirement.BlockedUsers 
.Any(user => user.Equals(context.Us 
er.Identity.Name, 
StringComparison.OrdinalIgnoreC 
ase))) { 
context. Succeed( requirement) ; 
} else { 
context.Fail(); 


} 


return Task.CompletedTask; 





BlockUserRequirement 类 是 需求 指定 用 来 创建 
党 略 的 数据 ， 在 这 个 示例 中 是 不 会 被 授权 访问 的 用 
户 列表 。BlockUsersHandler 关 的 职责 是 使 用 需求 数 
据 评 估 授 权 中 的 请 求 ， 该 类 派生 目 


AuthorizationHandler<T> 类 ，TT 是 需求 的 类 型 。 














当 授 权 系 统 需 要 检查 对 资源 的 访问 时 ， 处 理 程 
序 中 的 Handle 方 法 被 调用 。 这 个 方法 的 参数 古 
AuthorizationHandlerContext 对 象 ， 其 中 的 重要 成 员 
如 表 30-9 所 示 。 








表 30-9 ”AuthorizationHandlerContext 对 象 中 的 重要 成 员 











Succeed(requirement) | 如 果 请 求 符合 需求 ， 这 个 方法 将 被 调用 ， 参 数 对 象 


Fail() 请 求 不 符合 需求 ， 这 个 方法 将 被 调用 








IAuthorizationRequirement 由 Handle 方 法 接收 












































返回 用 于 授权 访问 单个 应 用 程序 资源 的 对 象 





代码 清 蛙 30-12 中 的 需求 处 理 程序 检 枉 用 户 的 
名 称 是 否 在 BlockUsersRequirement 对 象 提 供 的 被 禁 
止 的 名 单 中 ， 并 分 别 调用 Succeed 或 Fail 方 法 。 应 用 
目 定义 的 授权 需求 需要 执行 两 处 配置 变更 ， 如 代码 
清单 30-13 所 示 。 


代码 清单 30-13 ”在 Users 文 件 夹 下 的 Startup.cs 文 件 中 应 用 目 定 


义 的 授权 需求 





using 
using 
using 
using 
using 
using 
using 
using 
using 
using 


Microsoft.AspNetCore. Builder; 

Microsoft. Extensions .DependencyInjection; 
Microsoft.Extensions.Configuration; 
Microsoft.AspNetCore.Identity ; 

Microsoft. EntityFrameworkCore; 
Users.Models; 

Users.Infrastructure; 
Microsoft.AspNetCore. Authentication; 
System.Security.Claims; 
Microsoft.AspNetCore. Authorization; 


namespace Users { 
public class Startup { 


public Startup(IConfiguration configuration) => 
Configuration = configuration; 


public IConfiguration Configuration { get; } 


public void ConfigureServices(IServiceCollectio 
n services) { 


services.AddTransient<IPasswordValidator<Ap 
pUser>, 
CustomPasswordValidator>(); 
services.AddTransient<IUserValidator<AppUse 
r>, 
CustomUserValidator>() ; 
services.AddSingleton<IClaimsTransformation 
， LocationClaimsProvider>(); 
services.AddTransient<IAuthorizationHandler 
» BlockUsersHandler>() ; 


services.AddAuthorization(opts => { 
opts.AddPolicy("DCUsers", policy => { 
policy.RequireRole("Users") ; 
policy.RequireClaim(ClaimTypes.Stat 
eOrProvince, "DC"); 
}); 
opts.AddPolicy("NotBob", policy => { 
policy.RequireAuthenticatedUser() ; 
policy.AddRequirements(new BlockUse 
rsRequirement ("Bob") ) ; 
})5 
}); 


services.AddDbContext<AppIdentityDbContext> 
(options => 
options.UseSqlServer ( 
Configuration[ "Data:SportStoreIdent 
ity: ConnectionString"])); 


services.AddIdentity<AppUser, IdentityRole> 
(opts => { 
opts.User.RequireUniqueEmail = true; 
//opts.User.AllowedUserNameCharacters = 
“abcdefghijklmnopgrstuvwxyz" ; 
opts.Password.RequiredLength = 6; 
opts.Password.RequireNonAlphanumeric = 


false; 
opts.Password.RequireLowercase = false; 
opts.Password.RequireUppercase = false; 
opts.Password.RequireDigit = false; 
}) .AddEntityFrameworkStores<AppIdentityDbCo 
ntext>() 
.AddDefaultTokenProviders(); 
services.AddMvc(); 
} 
public void Configure(IApplicationBuilder app) 
{ 


app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseAuthentication() ; 
app.UseMvcWithDefaultRoute() ; 





第 一 步 是 将 处 理 程序 类 与 服务 提供 者 注册 为 
IAuthorizationHandler 接 口 的 实现 。 第 二 步 是 使 用 
AddRequirements 7735} Axe SCA a KARIN FI R 
HH, UR tas: 








opts.AddPolicy("NotBob", policy => { 
policy.RequireAuthenticatedUser() ; 


policy.AddRequirements(new BlockUsersRequirement("B 








得 到 的 结果 是 一 个 策略 ， 它 要 求 用 户 不 是 
Bob， 并 且 可 以 使 用 Authorize 特 性 通过 指定 策略 名 
称 来 应 用 ， 如 代码 清单 30-14 所 示 。 


代码 清单 30-14 ”在 HomeController.cs 文 件 中 应 用 自 定 义 策 略 





//[Authorize(Roles = "Users") ] 

[Authorize(Policy = "DCUsers") ] 

public IActionResult OtherAction() => View( "Index", Get 
Data(nameof(OtherAction) ) ); 


[Authorize(Policy = "NotBob") ] 


public IActionResult NotBob() => View( "Index", GetData( 
nameof(NotBob) ) ) ) ; 





如 果 以 Bob 刁 份 进行 验证 ， 将 不 能 访问 UREL 地 
址 /Home/NotBob， 但 是 其 他 的 账户 将 被 授权 访问 。 





30.3.4 ”使 用 策略 对 资源 授权 访问 


策略 也 可 以 对 单个 资源 进行 授权 访问 ， 资 源 是 
应 用 程序 中 任意 数据 项 的 广义 术语 ， 并 且 相 比 操作 
方法 级 别 需 要 更 精细 的 管理 。 作 为 演示 ， 将 一 个 名 
为 ProtectedDocument.cs 的 类 文件 添加 到 Models 文 件 
夹 中 ， 用 它 定 义 一 个 类 ， 以 表示 具有 所 有 权 属 性 的 
文档 ， 如 代码 清单 30-15 所 示 。 














代码 清单 30-15 Models 文 件 夹 下 的 ProtectedDocument.cs 文 件 
的 内 容 





namespace Users.Models { 


public class ProtectedDocument { 
public string Title { get; set; } 


public string Author { get; set; } 
public string Editor { get; set; } 





对 于 真实 文档 来 说 ， 这 只 是 一 个 占 位 伯 ， 关 键 
是 每 个 文档 只 能 由 两 种 人 修改 ， 分 别 是 作者 和 编 
辑 。 真 实 的 文档 需要 内 容 以 及 变更 跟踪 和 许多 其 他 
的 特性 ， 但 是 对 于 这 个 示例 已 经 足够 了 了。 在 
Controllers XF X 28044 AN DocumentController.cs 
的 类 文件 ， 并 用 它 定义 代码 清单 30-16 所 示 的 控制 
Ait o 








代码 清单 30-16 Controllers XF% FH) DocumentController.cs 
文件 的 内 容 





using Microsoft.AspNetCore.Authorization; 
using Microsoft.AspNetCore.Mvc; 

using System.Ling; 

using Users.Models; 


namespace Users.Controllers { 


[Authorize] 
public class DocumentController : Controller { 


private ProtectedDocument[] docs = new Protecte 
dDocument[] { 
new ProtectedDocument { Title = "Q3 Budget" 
» Author = "Alice", 
Editor = "Joe"}, 
new ProtectedDocument { Title = "Project Pl 
an", Author = "Bob", 
Editor = "Alice"} 
}; 


public ViewResult Index() => View(docs); 


public ViewResult Edit(string title) { 
return View("Index", docs.FirstOrDefault(d 
=> d.Title == title)); 
} 


} 





Document 控 制 颖 维护 一 个 固定 的 
ProtectedDocument 对 象 集合 ，ProtectedDocument 对 
象 用 在 Index 操 作 方 法 中 ， 并 传递 所 有 的 文档 给 
View 方 法 。Edit 操 作 方 法 基于 tite 参 数 选择 文档 。 

这 两 个 操作 方法 都 使 用 名 为 Index.cshtml 的 视图 文 
件 ， 将 它 添加 到 新 创建 的 名 为 Views/Document 的 文 
件 夹 中 ， 内 容 如 代码 清单 30-17 所 示 。 








代码 清单 30-17 Views/Document 文 件 夹 下 的 Index.cshtml 文 件 
的 内 容 





@if (Model is IEnumerable<ProtectedDocument>) { 
<div class="bg-primary m-1 p-1 text-white"> 
<h4>Documents (@User?.Identity?.Name)</h4> 
</div> 
<table class="table table-sm table-bordered"> 
<tr><th>Title</th><th>Author</th><th>Editor</th 
><th></th></tr> 
@foreach (var doc in Model) { 
<tr> 
<td>@doc.Title</td> 
<td>@doc.Author</td> 
<td>@doc.Editor</td> 
<td> 
<a class="btn btn-sm btn-primary" a 
sp-action="Edit" 
asp-route-title="@doc.Title"> 
Edit 
</a> 
</td> 
</tr> 
} 
</table> 
} else { 
<div class="bg-primary m-1 p-1"> 
<h4>Editing @Model.Title (@User?.Identity?.Name 
\</h4> 
</div> 
<div class="m-1 p-1"> 
Document editing feature would go here... 
</div> 
<a asp-action="Index" class="btn btn-primary">Done< 


/ay> 


<a asp-action="Logout" asp-controller="Account" class=" 
btn btn-danger">Logout</a> 





如 果 视 图 模型 是 ProtectedDocument 对 象 序列 ， 
那么 mdex 视 图 将 以 表格 的 形式 ， 在 每 行 中 显示 一 个 
文档 、 作 者 和 编辑 的 姓名 以 及 用 于 链接 到 Edit 操 作 
的 链接 。 如 果 视 图 模型 是 单个 ProtectedDocument 对 
象 ， 那 么 Index 视 图 将 显示 一 些 占 位 从 ， 用 于 为 应 用 
程序 提供 编辑 功能 











此 刻 ， 只 有 应 用 于 DocumentController 类 的 
Authorize 特 性 的 授权 限制 ， 这 意味 看 任何 用 户 都 可 
以 编辑 任意 文档 ， 而 不 仅仅 是 作者 和 编辑 。 可 以 通 
过 执行 应 用 程序 来 查看， 访问 /Document， 以 任意 
应 用 程序 用 户 进 行 验 证 ， 然 后 单 击 文档 的 Edit 按 
钮 。 例 如 ， 图 30-6 表 明 用 户 Joe 可 以 编辑 Project Plan 
文档 。 











图 30-6 ”编辑 文档 


创建 资源 授权 策略 和 处 理 程序 


很 难 在 操作 方法 级 别 限制 对 单个 文档 的 访问 ， 
因为 Authorize 特 性 是 在 操作 方法 执行 前 评估 的 。 这 
意味 着 在 提取 和 检查 ProtectedDocument 对 象 之 前 ， 
哪些 用 户 应 该 被 允许 访问 文档 的 决定 已 经 做 完 。 





这 个 问题 的 解决 方案 是 创建 授权 策略 和 处 理 程 
序 ， 它 们 知道 如 何 处 理 ProtectedDocument 对 象 ， 并 
在 用 户 的 详情 被 展现 之 后 在 操作 方法 中 使 用 它们 。 
为 了 演示 ， 在 Infrastructure 交 件 夹 中 添加 名 为 
DocumentAuthorization.cs 的 类 文件 ， 并 用 它 定义 代 
码 清单 30-18 所 示 的 类 。 


代码 清单 30-18 Infrastructure LFR R F H 
DocumentAuthorization.cs 文 件 的 内 容 





using System; 

using System.Threading.TasKs ; 

using Microsoft.AspNetCore. Authorization; 
using Users.Models; 


namespace Users.Infrastructure { 


public class DocumentAuthorizationRequirement : IAu 
thorizationRequirement { 
public bool AllowAuthors { get; set; } 
public bool AllowEditors { get; set; } 


I 


public class DocumentAuthorizationHandler 
: AuthorizationHandler<DocumentAuthorizationReq 
uirement> { 


protected override Task HandleRequirementAsync( 
AuthorizationHandlerContext context, 
DocumentAuthorizationRequirement requir 
ement) { 
ProtectedDocument doc = context.Resource as 
ProtectedDocument; 
string user = context.User.Identity.Name; 
StringComparison compare = StringComparison 
.OrdinalIgnoreCase; 
if (doc != null && user != null && 
(requirement.AllowAuthors && doc.Author 
.Equals(user, compare) ) 
|| (requirement.AllowEditors && doc.Edi 
tor.Equals(user, compare))) { 


context.Succeed(requirement) ; 
} else { 
context.Fail(); 


} 
return Task.CompletedTask; 





AuthorizationHandlerContext®t & fe tk y 
Resource 属 性 ， 从 而 提供 对 可 以 检查 授权 的 对 象 的 
访问 。DocumentAuthorizationHandler 类 检查 
Resource 属 性 是 否 为 ProtectedDocument 对 象 ， 如 果 
和 是， 就 检查 当前 用 户 是 否 为 作者 和 编辑 ， 以 及 
DocumentAuthorizationRequirement} % ze 75 Iù VF r 


辑 或 作者 访问 文档 。 




















代码 清单 30-19 已 经 注册 
DocumentAuthorizationHandler 类 作为 
DocumentAuthorizationRequirement 需 求 的 处 理 类 ， 


并 定义 了 上 其 有 这 一 需求 的 打上 略 。 


代码 清单 30-19 ”在 Users 文 件 夹 下 的 Startup.cs 文 件 中 注册 处 理 
程序 和 定义 策略 





public void ConfigureServices(IServiceCollection servic 


es) { 


services.AddTransient<IPasswordValidator<AppUser>, 
CustomPasswordValidator>(); 
services.AddTransient<IUserValidator<AppUser>, 
CustomUserValidator>(); 
services.AddSingleton<IClaimsTransformation, Locati 
onClaimsProvider>() ; 
services.AddTransient<IAuthorizationHandler, BlockU 
sersHandler>(); 
services.AddTransient<IAuthorizationHandler, Docume 
ntAuthorizationHandler>() ; 


services.AddAuthorization(opts => { 
opts.AddPolicy("DCUsers", policy => { 
policy.RequireRole("Users") ; 
policy.RequireClaim(ClaimTypes.StateOrProvi 
nce, "DC"); 
})5 
opts.AddPolicy("NotBob", policy => { 
policy.RequireAuthenticatedUser() ; 
policy.AddRequirements(new BlockUsersRequir 
ement("Bob")); 
})5 
opts.AddPolicy("AuthorsAndEditors", policy => { 
policy.AddRequirements(new DocumentAuthoriz 
ationRequirement { 
AllowAuthors 
AllowEditors 


true, 
true 


}); 
}); 
}); 


services .AddDbContext<AppIdentityDbContext>(options 
=> 
options.UseSqlServer ( 
Configuration[ "Data: SportStoreIdentity:Conn 
ectionString" ])); 


services.AddIdentity<AppUser, IdentityRole>(opts => 


opts.User.RequireUniqueEmail = true; 
//opts.User.AllowedUserNameCharacters = “abcdef 
ghijklmnopqrstuvwxyz" ; 

opts.Password.RequiredLength = 6; 
opts.Password.RequireNonAlphanumeric = false; 
opts.Password.RequireLowercase = false; 
opts.Password.RequireUppercase = false; 
opts.Password.RequireDigit = false; 

}) .AddEntityFrameworkStores<AppIdentityDbContext>() 
.AddDefaultTokenProviders() ; 


services.AddMvc(); 








最 后 的 步骤 是 为 操作 方法 应 用 授权 策略 ， 如 代 
码 清 单 30-20 所 示 。 


代码 清单 30-20 Controllers CES FY 





DocumentController.cs 文 件 中 应 用 授权 策略 





using Microsoft.AspNetCore. Authorization; 
using Microsoft.AspNetCore.Mvc; 

using System.Ling; 

using Users.Models; 

using System. Threading. Tasks; 


namespace Users.Controllers { 


[Authorize] 
public class DocumentController : Controller { 
private ProtectedDocument[] docs = new Protecte 
dDocument[] { 
new ProtectedDocument { Title 
» Author = "Alice", 
Editor = "Joe"}, 
new ProtectedDocument { Title = "Project Pl 
an", Author = "Bob", 
Editor = "Alice"} 


"Q3 Budget" 


p 


private IAuthorizationService authService; 


public DocumentController(IAuthorizationService 
auth) { 
authService = auth; 


} 


public ViewResult Index() => View(docs) ; 


public async Task<IActionResult> Edit(string ti 
tle) { 
ProtectedDocument doc = docs.FirstOrDefault 
(d => d.Title == title); 


AuthorizationResult authorized = await auth 
Service.AuthorizeAsync(User, 
doc, "AuthorsAndEditors") ; 
if (authorized.Succeeded) { 
return View("Index", doc); 
} else { 
return new ChallengeResult(); 





DocumentController 控 制 器 类 的 构造 函数 定义 
了 IAuthorizationService 参 数 ， 从 而 提供 了 用 于 评估 
授权 策略 的 方法 ， 并 通过 依赖 注入 提供 。 在 Edit 操 
作 方 法 中 ， 调 用 AuthorizeAsync 方 法 ， 传 入 当前 的 
用 户 、ProtectedDocument 对 象 以 及 应 用 的 策略 名 
称 。 如 果 AuthorizeAsync 方 法 返回 true， 授 权 被 批 
准 ， 然 后 View 方 法 被 调用 ;如 采 返 回 false， 就 表示 
存在 授权 问题 ， 返 回 一 个 ChallengeResult 对 象 ， 如 
第 17 章 所 述 ， 以 告诉 MVC 验 证 失败 。 





可 以 通过 执行 应 用 程序 并 访问 URL 地 





址 /Document 来 得 看 效果 ， 以 不 同 的 用 户 身 份 进行 
验证 ， 例 如 以 Joe 喘 份 进 行 验证 ， 你 将 能 够 编辑 预 
算 文 要 ， 但 是 不 能 编辑 项 目 计 划 文 档 。 





30.4 使 用 第 By = Fy Ser iE 


基于 声明 的 系统 (如 ASP.NET Core Identity) 
的 优势 之 一 是 ， 任 何 声 aaa 目 外 部 系统 ， 其 
至 来 自 识 别 用 户 的 应 用 程序 。 这 意味 着 其 他 系统 可 
以 代表 应 用 程序 对 用 户 进行 身份 验证 ，ASP.NET 
Core Identity 残 建立 在 这 种 想法 之 上 ， 可 以 简单 且 
容易 地 添加 通过 Microsoft、Google、Facebook 和 和 
Twitter 等 第 三 方 对 用 户 进行 对 份 验 证 的 功能 


使 用 第 三 方 验证 有 很 多 好 处 : WBA OA 
有 账户 ， 用 户 可 以 选择 使 用 双 因 子 验证 ， 而 不 必 在 
应 用 中 管理 用 户 和 凭据 。 随 后 的 章节 将 展示 如 何 为 
Google 用 户 设 置 和 使 用 第 三 方 身 份 验证 。 














30.4.1 注册 Google 心 用 


在 可 以 验证 用 户 映 份 之 前 ， 第 三 方 吴 份 验 证 服 
务 通常 需要 注册 应 用 程序 。 注 册 结 果 是 包含 在 针对 
第 三 方 服务 的 认证 请 求 中 的 凭据。 注册 过 程 可 在 
Google 开 友人 员 网 站 上 进行 ， 请 按照 其 中 的 说 明 进 
行 操 作 。 必 须 指 定 回 调 地 址 ， 默 认 配置 为 /signin- 
google。 如 果 正 在 开发 ， 可 设置 回调 地 址 为 
http://localhost:port/signin-google。 对 于 生产 型 应 
用 ， 可 创建 包含 公共 主机 名 和 并 口 的 URL 地 址 。 








完成 注册 过 程 后 ， 你 将 收 到 客户 问 ID， 用 于 将 
应 用 程序 标识 给 Google， 还 将 收 到 客户 窗 钥 ， 以 防 
止 其 他 应 用 程序 伪装 成 你 的 应 用 程序 。 





E 


v> ae 
cE. 22 


你 必须 注册 目 己 的 应 用 程序 ， 并 使 用 注册 过 程 
ERAP mR AP im ID) MH. RAEE 
用 应 用 程序 的 唯一 值 更 改 和 凭据 ， 否 则 代码 无 法 工 
作 。 微 软 提供 了 名 为 用 户 密 钥 Cuser secret) 的 功 
能 ， 人 多 许 你 将 安全 信息 存储 到 外 部 配置 文件 中 ， 但 
为 了 人 徐 单 起 见 ， 将 假设 你 的 配置 文件 不 是 共 孕 的 ， 
并 且 可 以 安全 地 包含 Google 喘 份 验证 凭据。 

















30.4.2 ”局 用 Google 验 证 


ASP.NET Core Identity 内 置 支持 通过 
Microsoft、Google、Facebook 和 Twitter 账 号 对 用 户 
里 份 进行 验证 ， 还 提供 对 文 持 OAuth 的 任意 身份 验 
证 服务 的 普 过 文 持 。 每 种 服务 都 有 上 自己 的 在 Startup 
关中 注册 到 应 用 的 扩展 方法 ， 代 码 清 单 30-21 展 示 





了 Google 服 务 是 如 何 设置 的 。 为 了 简洁 起 见 ， 这 里 
删除 了 上 一 示例 中 的 配置 语句 。 


代码 清单 30-21 在 Users 文 件 夹 下 的 Startup.cs 文 件 中 局 用 
Google 验 证 





public void ConfigureServices(IServiceCollection servic 


es) { 


services.AddTransient<IPasswordValidator<AppUser>, 
CustomPasswordValidator>(); 
services.AddTransient<IUserValidator<AppUser>, 
CustomUserValidator>(); 
services.AddSingleton<IClaimsTransformation, Locati 
onClaimsProvider>(); 
services.AddTransient<IAuthorizationHandler, BlockU 
sersHandler>(); 
services.AddTransient<IAuthorizationHandler, Docume 
ntAuthorizationHandler>() ; 
services.AddAuthorization(opts => { 
opts.AddPolicy("DCUsers", policy => { 
policy.RequireRole("Users"); 
policy.RequireClaim(ClaimTypes.StateOrProvi 
nce, "DC"); 
}); 
opts.AddPolicy("NotBob", policy => { 
policy.RequireAuthenticatedUser() ; 
policy.AddRequirements(new BlockUsersRequir 
ement("Bob") ) ; 


}); 


opts.AddPolicy("AuthorsAndEditors", policy => { 
policy.AddRequirements(new DocumentAuthoriz 
ationRequirement { 


AllowAuthors = true, 
AllowEditors = true 
})5 
})5 
}); 
services.AddAuthentication().AddGoogle(opts => { 
opts.ClientId = "<enter client id here>"; 
opts.ClientSecret = "<enter client secret here> 


}); 


services .AddDbContext<AppIdentityDbContext>(options 
options.UseSqlServer ( 
Configuration[ "Data:SportStoreIdentity:Conn 
ectionString"])); 


services.AddIdentity<AppUser, IdentityRole>(opts => 


opts.User.RequireUniqueEmail = true; 
opts.Password.RequiredLength = 6; 
opts.Password.RequireNonAlphanumeric = false; 
opts.Password.RequireLowercase = false; 
opts.Password.RequireUppercase = false; 
opts.Password.RequireDigit = false; 

}) .AddEntityFrameworkStores<AppIdentityDbContext>() 
.AddDefaultTokenProviders() ; 


services.AddMvc(); 





AddAuthentication.AddGoogle 方 法 设置 了 使 用 
Google 验 证 用 户 时 必要 的 服务 ， 以 及 在 注册 过 程 中 
创建 的 客户 端 ID 和 用 户 密 铀 。 


当 使 用 第 三 方 验证 用 户 时 ， 可 以 选择 在 Identity 
数据 库 中 创建 用 户 ， 然 后 用 于 管理 角色 和 声明 ， 丈 
像 普 通用 户 一 样 。 在 第 28 章 中 ， 添 加 了 用 户 验证 
类 ， 如 果 电 子 邮件 地 址 不 在 example.com 域 中 ， 则 
可 以 阻止 创建 用 户 。 由 于 要 处 理 来 自任 意 域 的 所 有 
用 户 ， 因 此 必须 在 该 例 中 共用 电子 邮件 地 址 检查 ， 
如 代码 清单 30-22 所 示 。 














代码 清单 30-22 ”在 Infrastructure 文件 夹 下 的 
CustomUserValidator.cs 文 件 中 禁用 验证 





using System.Collections.Generic; 
using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Identity; 
using Users.Models; 


namespace Users.Infrastructure { 


public class CustomUserValidator : UserValidator<Ap 
pUser> { 


public override async Task<IdentityResult> Vali 
dateAsync( 
UserManager<AppUser> manager, 
AppUser user) { 


IdentityResult result = await base.Validate 
Async(manager, user); 


List<IdentityError> errors = result.Succeed 
ed ? 
new List<IdentityError>() : result.Erro 
rs.ToList(); 


//if (!user.Email.ToLower().EndsWith("@exam 
ple.com")) { 
// errors.Add(new IdentityError { 


// Code = "EmailDomainError", 

// Description = "Only example.com e 
mail addresses are allowed" 

// }); 

//} 

return errors.Count == © ? IdentityResult.S 


uccess 


: IdentityResult.Failed(errors.ToArray( 





然后 在 Views/Account/Login.cshtml 文 件 中 添加 


一 个 按钮 ， 以 允许 用 户 通 过 Google 登 录 ， 如 代码 清 
单 30-23 所 示 。Google 为 按钮 提供 了 图 像 ， 使 它们 与 
文 持 Google 账 户 的 其 他 应 用 程序 保持 一 致 。 但 为 了 
简单 起 见 ， 这 里 仅 创 建 一 个 标准 按钮 。 


代码 清单 30-23 ”在 Views/Account 文 件 夹 下 的 Login.cshtml 文 件 
中 添加 按钮 





@model LoginModel 


<div class="bg-primary m-1 p-1 text-white"><h4>Log In</ 
h4></div> 


<div class="text-danger" asp-validation-summary="Al1">< 
/div> 


<form asp-action="Login" method="post"> 
<input type="hidden" name="returnUrl" value="@ViewB 
ag.returnUrl" /> 
<div class="form-group"> 
<label asp-for="Email"></label> 
<input asp-for="Email" class="form-control" /> 
</div> 
<div class="form-group"> 
<label asp-for="Password"></label> 
<input asp-for="Password" class="form-control" 
/> 
</div> 
<button class="btn btn-primary" type="submit">Log I 


n</button> 
<a class="btn btn-info" asp-action="GoogleLogin" 


asp-route-returnUrl="@ViewBag.returnUr1l"> 
Log In With Google 


</a> 
</form> 





新 按钮 指向 Account 控 制 右 的 GoogleLogin 操 作 


方法 。 


可 以 看 看 这 个 操作 方法 ， 以 及 对 控制 右 所 做 


的 其 他 更 改 ， 如 代码 清单 30-24 所 示 。 


代码 清单 30-24 ”在 Controllers 文 件 夹 下 的 AccountController.cs 





文件 中 添加 对 Google 验 证 的 支持 





using 
using 
using 
using 
using 
using 
using 


System. Threading.Tasks; 
Microsoft.AspNetCore.Authorization; 
Microsoft.AspNetCore.Mvc; 

Users.Models; 

Microsoft.AspNetCore. Identity; 
System.Security.Claims ; 
Microsoft.AspNetCore.Http.Authentication; 


namespace Users.Controllers { 


[Authorize] 
public class AccountController : Controller { 


private UserManager<AppUser> userManager; 
private SignInManager<AppUser> signInManager ; 


// ...methods omitted for brevity... 


[AllowAnonymous ] 
public IActionResult GoogleLogin(string returnU 
rl) { 
string redirectUrl = Url.Action("GoogleResp 
onse", "Account", 
new { ReturnUrl = returnUrl }); 
var properties = signInManager 
.ConfigureExternalAuthenticationPropert 
ies("Google", redirectUr1) ; 
return new ChallengeResult("Google", proper 
ties); 


} 


[AllowAnonymous] 
public async Task<IActionResult> GoogleResponse 
(string returnUrl = "/") { 
ExternalLoginInfo info = await signInManage 
r.GetExternalLoginInfoAsync() ; 
if (info == null) { 
return RedirectToAction(nameof (Login) ) ; 
} 
var result = await signInManager.ExternalLo 
ginSignInAsync( 
info.LoginProvider, info.ProviderKey, f 
alse); 
if (result.Succeeded) { 
return Redirect(returnur1) ; 
} else { 
AppUser user = new AppUser { 
Email = info.Principal.FindFirst(Cl 
aimTypes.Email).Value, 
UserName = 
info.Principal.FindFirst(ClaimT 
ypes.Email).Value 


}3 


IdentityResult identResult = await user 
Manager .CreateAsync(user) ; 
if (identResult.Succeeded) { 
identResult = await userManager.Add 
LoginAsync(user, info); 
if (identResult.Succeeded) { 
await signInManager.SignInAsync 
(user, false); 
return Redirect(returnuUr1) ; 


} 


} 


return AccessDenied(); 





GoogleLogin 操 作 方 法 创建 了 一 个 
AuthenticationProperties 实 例 ， 并 将 RedirectUri 属 性 
设置 为 同一 控制 器 中 的 GoogleResponse 操 作 方 法 的 
URL。 以 下 代码 导致 ASP.NET Core Identity 通 过 将 
用 户 重 定 同 到 Google 吴 份 验证 页 面 而 不 是 应 用 程序 
定义 的 内 容 来 啊 应 未 授权 错误 : 

















return new ChallengeResult("Google", properties) ; 





LARE HME AE Log In 投 钮 登录 时 ， 
他 们 的 浏览 右 将 被 重 定 同 到 Google 验 证 服务 ， 然 后 
一 旦 被 验证 ， 束 被 重 定 同 到 GoogleResponse 操 作 方 
法 。 在 GoogleResponse 操 作 方 法 中 ， 可 通过 调用 
SigninManager 的 GetExternalLoginInfoAsync 方 法 来 
获取 外 部 登录 的 详细 信息 ， 如 下 上 所 示 : 











ExternalLogininfo info = await signInManager.GetExterna 





lLoginInfoAsync() ; 


ExternalLoginInfo 类 定义 了 ExternalPrincipal 属 
性 ， 该 属性 返回 一 个 ClaimsPrincipal 对 象 ， 该 对 象 
包含 由 Google 为 用 户 生 成 的 声明 。 可 使 用 
ExternalLoginSignInAsync 方 法 让 用 户 登 录 应 用 程 
Fe, UR Ata: 











var result = await signInManager.ExternalLoginSignInAsy 
nc( 


info.LoginProvider, info.ProviderKey, f 


登录 失败 ， 这 是 因为 数据 库 中 没有 代表 Google 
用 户 的 账户 ， 可 创建 新 用 户 并 将 Google 账 户 与 之 天 
联 ， 方 法 是 使 用 如 下 两 条 语句 : 











IdentityResult identResult = await userManager.CreateAs 
ync(user) ; 


identResult = await userManager.AddLoginAsync(user, inf 
o); 





当 创 建 Identity 用 户 时 ， 可 使 用 Google 提 供 的 电 
子 邮 件 声明 并 用 于 AppUser 对 象 的 Email 和 UserName 





属性 ， 以 便 不 与 数据 库 中 现存 的 任何 用 户 发 生命 名 
冲突 。 


为 了 测试 验证 ， 局 动 应 用 程序 ， 单 击 Log niž 
钮 进行 登录 ， 并 提供 有 效 的 Google 账 户 凭 据 。 完 成 
验证 之 后 ， 浏 虎 带 将 被 重 定 同 到 应 用 程序 。 





30.5 小结 


本 章 展 示 了 ASP.NET Core Identity 支 持 的 一 些 
高 级 功能 ， 演 示 了 使 用 目 定 义 属 性 以 及 如 何 使 用 数 
据 库 迁 移 来 更 新 数据 库 模 式 以 执行 它们 ， 解 释 了 声 
明 如 何 工作 以 及 如 何 使 用 它们 通过 咒 略 来 创建 更 灵 
活 的 授权 用 户 ， 还 解释 了 如 何 使 用 策略 来 控制 对 应 
用 程序 管理 单个 资源 的 访问 ， 以 及 如 何 使 用 Google 
验证 用 户 。 下 一 草 将 介绍 如 何 实现 MVC 应 用 程序 中 

















使 用 的 一 些 最 重要 的 约定 ， 以 及 如 何在 目 己 的 应 用 
程序 中 目 定 义 它 们 。 








第 31 章 ”模型 约定 与 操作 约束 





本 章 描述 两 个 用 于 自 定 义 MVC 工 作 方式 的 有 
用 特性 : 模型 约定 允许 蕉 换 用 于 创建 控制 器 和 操作 
的 默认 约定 ; 操作 约束 允许 指定 操作 可 用 于 何 种 类 
型 的 请 求 ， 当 MVC 选 择 操作 以 处 理 请 求 时 ， 可 提供 


指导 。 








表 31-1 列 出 了 本 章 要 介绍 的 操作 。 


表 31-1 本 章 要 介绍 的 操作 
































使 用 内 置 的 特性 之 一 或 者 创建 自 定义 | 代码 清单 31-1 一 代码 清 
的 模型 约定 单 31-14 











自 定义 应 用 模型 














在 整个 应 用 程序 中 应 用 自 PE 代码 清单 31-15 和 代码 清 


A 




















定义 约定 单 31-16 




















区 分 可 以 处 理 请 求 的 两 种 





























使 用 action 约 定 代码 清单 31-17 一 代码 清 














操作 方法 单 31-25 
31.1 准备 示例 项 目 


在 本 章 中 ， 使 用 ASP.NET Core Web 
Application (.NET Core) 模板 创建 新 的 名 为 
ConventionsAndConstraints 的 Empty 项 目 。 代 码 清 单 
31-1 展 示 的 Startup 类 用 来 设置 MVC 框 架 和 用 于 开 友 
的 中 间 件 。 


代码 清单 31-1 ”ConventionsAndConstraints 文 件 夹 下 的 Startup.cs 
文件 的 内 容 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 


namespace ConventionsAndConstraints { 


public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 


services.AddMvc(); 


} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 





创建 视图 模型 、 控 制 器 和 视图 


对 于 本 草 的 大 多 数 示 例 ， 知 道 哪个 方法 用 于 啊 
应 请 求 是 有 帮助 的 。 为 此 ， 创 建 Models 文 件 夹 并 在 
其 中 添加 名 为 Result.cs 的 类 文件 ， 用 它 定义 代码 清 
单 31-2 所 示 的 类 。 这 个 类 将 允许 本 章 中 的 控制 左 将 
请 求 是 如 何 处 理 的 信息 传递 给 视图 。 











代码 清 蛙 31-2 ”Models 文 件 夹 下 的 Result.cs 文 件 的 内 容 


using System.Collections.Generic; 


namespace ConventionsAndConstraints.Models { 


public class Result { 
public string Controller { get; set; } 
public string Action { get; set; } 





本 间 只 需要 一 个 控制 器 和 视图 。 创 建 
Controllers LFK, EEFIN 
HomeController.cs 的 类 文件 ， 并 用 它 定 义 代码 清单 
31-3 所 示 的 类 。 


代码 清单 31-3 ”Controllers 文 件 夹 下 的 HomeController.cs 文 件 的 


内 容 





using ConventionsAndConstraints.Models; 
using Microsoft.AspNetCore.Mvc; 


namespace ConventionsAndConstraints.Controllers { 
public class HomeController : Controller { 


public IActionResult Index() => View("Result", 
new Result { 
Controller = nameof(HomeController), 
Action = nameof( Index) 


}); 


public IActionResult List() => View("Result", n 
ew Result { 


Controller = nameof(HomeController), 
Action = nameof(List) 





Home 控 制 器 中 的 两 个 操作 方法 都 泻 染 名 为 
Result 的 视图 ， 创 建 Views/Home 文 件 夹 ， 并 使 用 代 
码 清单 31-4 所 示 的 标记 内 容 在 其 中 创建 
Result.cshtml 视 图 文件 。 





代码 清单 31-4 ”Views/Home 文 件 夹 下 的 Result.cshtml 文 件 的 内 


IP 


谷 





@model Result 
@{ Layout = null; } 


<!DOCTYPE html> 
<html> 
<head> 

<meta name="viewport" content="width=device-width" 
/> 

<link href="/1ib/bootstrap/dist/css/bootstrap.min.c 
ss" rel="stylesheet" /> 

<title>Result</title> 
</head> 


<body class="m-1 p-1"> 
<table class="table table-sm table-bordered"> 
<tr><th>Controller:</th><td>@Model.Controller</ 
td></tr> 


<tr><th>Action: </th><td>@Model .Action</td></tr> 
</table> 
</body> 
</html> 





Result 视 图 基于 Bootstrap CSS 包 为 HTML 元 素 
设置 样式 。 要 将 Bootstrap 包 添加 到 项 目 中 ， 可 以 使 
用 Bower Configuration File 模 板 创 建 bower.json 文 
件 ， 并 将 Bootstrap 包 添加 到 dependencies 部 分 ， 如 代 
码 清单 31-5 所 示 。 


代码 清单 31-5 ”添加 Bootstrap 包 到 ConventionsAndConstraints 文 
件 夹 下 的 bower.json 文 件 中 


{ 
"name": "asp.net", 
"private": true, 
"dependencies": { 


"bootstrap": "4.0.0-alpha.6" 
} 





} 


最 后 的 准备 步骤 是 在 Views 文 件 夹 中 创建 
_ViewImports.cshtml 文 件 ， 从 而 设置 内 置 的 标签 助 
手 ， 将 之 用 于 Razor 视 图 并 导入 Models 命 名 空间 ， 
如 代码 清单 31-6 所 示 。 


代码 清单 31-6 ”Views 文件 夹 下 的 _ViewImports.cshtml 文 件 的 内 


PZ 


谷 


@using ConventionsAndConstraints.Models 
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 


如 果 运 行 应 用 程序 ， 你 将 看 到 图 31-1 所 示 的 结 





图 31-1 运行 示例 应 用 程序 的 结 


31.2 ”使 用 应 用 程序 模型 和 模型 约定 





MVC 偏 爱 约定 胜 于 配置 ， 因 此 ， 可 以 简单 地 
创建 名 称 以 Controller 结 尾 的 类 ， 并 开始 定义 操作 方 
法 。 在 运行 时 ，MVC 使 用 发 现 过 程 来 定位 应 用 中 所 
有 的 控制 医 和 操作 方法 ， 并 检查 它们 是 人 否 使 用 了 过 
滤器 等 特性 。 





























发 现 过 程 的 最 终结 果 束 是 应 用 程序 模型 ， 由 摘 
述 每 个 找到 的 控制 器 类 、 操 作 方 法 和 参数 的 对 象 组 
成 。MVC 依 赖 的 约定 在 构建 时 被 应 用 于 应 用 程序 模 
型 。 例 如 ， 当 发 现 控制 器 类 时 ， 交 的 名 称 用 于 在 模 
型 中 作为 表示 控制 器 的 基础 ， 换 句 话说 ， 
HomeController 类 用 来 创建 名 为 Home 的 控制 器 。 当 
路 由 系统 识别 必须 由 Home 控 制 器 处 理 的 请 求 时 ， 
应 用 程序 模型 提供 到 HomeController 类 的 映射 。 








应 用 程序 模型 可 以 通过 模型 约定 进行 定制 ， 模 
型 约定 是 用 于 检查 应 用 程序 模型 内 容 并 进行 调整 的 
类 ， 例 如 合成 新 的 操作 方法 或 者 用 于 创建 控制 絮 的 





方式 等 。 本 市 将 说 明 应 用 程序 模型 的 结构 ， 介 绍 不 
同类 型 的 模型 约定 ， 并 演示 模型 约定 的 使 用 方式 。 
表 31-2 提 供 了 应 用 程序 模型 和 模型 约定 的 上 下 文 。 


表 31-2 应 用 程序 模型 和 模型 约定 的 上 下 文 























程序 模型 是 对 应 用 程序 中 发 现 的 控制 器 和 操作 方法 的 完整 描述 。 
9 定义 的 更 改 应 用 于 应 用 程序 模型 


























































































































晶 约 定 有 用 是 因为 它们 人 允许 更 改 将 类 和 方法 映射 到 控制 器 和 操作 方法 的 方 
。 可 以 执行 其 他 的 定制 化 操作 ， 例 如 限制 操作 可 以 接收 的 HTTP 方 法 ， 或 者 
操作 约束 等 〈 本 章 稍 后 介绍 ) 

















































































































模型 约定 使 用 一 系列 接口 来 定义 ， 后 面 将 进行 说 明 ， 可 作为 特性 



































Startup 类 中 进行 配置 














| 在 模型 约定 的 应 用 方式 上 有 一 些 怪异 






































没有 ， 如 果 默 认 的 应 用 程序 模型 不 满足 需要 ， 可 以 通过 引入 自 定义 组 人 
自 定义 的 应 用 程序 模型 



























































31.2.1 理解 应 用 程序 模型 


在 发 现 过 程 中 ，MVC 创 建 ApplicationModel 类 
的 实例 ， 并 使 用 找到 的 控制 器 和 操作 方法 详情 进行 
填充 。 当 发 现 过 程 完 成 之 后 ， 应 用 模型 约定 以 执行 
指定 的 任何 自 定 义 更 新 。 理 解 应 用 程序 模型 的 起 点 
征 查 看 由 
Microsoft.AspNetCore.Mvc.Application Models.Applic. 
类 定义 的 属性 ， 如 表 31-3 所 示 。 


4231-3 ”ApplicationModel 类 定义 的 属性 






























返回 应 用 程序 中 包含 的 所 有 控制 器 的 IList<ControllerModel> 
返回 应 用 程序 中 包含 的 全 局 过 滤器 的 IList<IFilterMetadata> 























刚 开 始 看 起 来 有 些 枯燥 ， 特 列 是 当 想 深入 细 贡 
时 ， 本 布 介绍 的 闫 完全 描述 了 MVC 应 用 程序 的 核心 


分， 值得 论点 时 间 来 体会 。 理 解 应 用 程序 模型 的 
工作 原理 将 有 助 于 你 理解 更 多 的 高 级 功 
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时 ， 这 更 有 助 于 诊断 问题 。 





如 何在 


Controllers 属 性 会 返回 一 个 包含 应 用 程序 中 发 
现 的 对 应 每 个 控制 器 的 ControllerModel 对 象 列表 。 


表 31-4 介 绍 ControllerModel 类 定义 的 属性 。 


生 
表 31-4 ”ControllerModel 类 定义 的 属性 


















































这 个 string 类 型 的 属性 定义 了 控制 器 的 名 称 ， 以 匹配 controller 路 | 
中 的 名 称 


ControllerType 这 个 TypeInfo 类 型 的 属性 定义 了 控制 器 的 类 型 
ControllerProperties | ; Hl) ase SC A Finck ATA Je ME List<PropertyModel> i) 
pm Bue 


ControllerName 



















































































返回 控制 器 中 应 用 于 所 有 操作 方法 的 过 滤器 的 IList<IFilterMetadata> 列 
liters 


返回 由 控制 器 定义 的 如 何 路 由 目标 操作 方法 的 路 由 约束 的 























RouteConstraints 
IList<IRouteConstraintProvider> 列 表 


Sel 返回 包含 操作 方法 约束 详情 的 IList<SelectorModel> 列 表 ， 以 及 通过 特 
electors 
性 应 用 于 控制 器 的 路 由 信息 


由 此 可 以 看 到 MVC 的 一 些 核心 功能 是 如 何 被 
应 用 程序 模型 捕获 的 。 例 如 ，ControllerName 属 性 
用 于 设置 路 由 系统 用 来 匹配 UREL 的 名 称 ， 而 
ControllerType 属 性 用 于 设置 控制 右 名 称 关 联 的 类 。 












































ControllerProperties 属 性 返回 一 个 PropertyModel 
对 象 列表 ， 其 中 的 每 个 PropertyModel 对 象 描述 控制 
器 定义 的 一 个 属性 。 表 31-5 介 绍 了 PropertyModel 类 
定义 的 属性 。 


表 31-5 ”PropertyModel 类 定义 的 属性 




















属性 的 特性 列表 








Actions 属 性 返回 一 个 ActionModel 对 象 列表 ， 
其 中 的 每 个 ActionModel 对 象 描述 由 单个 控制 堪 类 
定义 的 一 个 操作 方法 。 表 31-6 描 述 了 ActionModel 类 
定义 的 属性 。 


表 31-6 ”ActionModel 类 定义 的 属性 

































































ActionName 这 个 string 类 型 的 属性 定义 了 操作 的 名 称 ， 用 于 匹配 action 路 由 片段 


ActionMethod ”| 这 个 MethodInfo 类 型 的 属性 用 来 指定 实现 操作 的 方法 
























































pease eee 
返回 应 用 于 操作 的 过 滤器 列表 IList<IFilterMetadata> 











返回 操作 的 方法 参数 描述 列表 IList<PropertyModel> 
返回 用 来 限制 如 何 路 由 到 操作 的 列表 IList<IRouteConstraintProvider> 


返回 描述 操作 约束 的 列表 IList<SelectorModel>， 以 及 通过 特性 作用 于 控 
electors 
制 器 的 路 由 信息 


终极 的 详细 信息 可 通过 Parameters 属 性 访问 ， 
该 属性 返回 描述 操作 方法 定义 的 每 个 参数 的 
ParameterModel 对 象 列表 。 表 31-7 描 述 了 
ParameterModel 类 定义 的 属性 。 
















































































表 31-7 ParameterModel 类 定义 的 属性 





























ParameterName 这 个 string 类 型 的 属性 表示 参数 名 称 





ParameterInfo 表示 指定 的 参数 信息 
































ApplicationModel、ControljerModel、 
PropertyModel、ActionModel 和 了 ParameterModel 用 于 
描述 应 用 程序 中 控制 器 闫 的 各 个 方面 ， 比 如 方法 、 
属性 以 及 每 个 方法 定义 的 参数 。 





目 定 义 应 用 程序 异型 


MVC 有 一 些 内 置 的 约定 ， 可 使 用 
ControllerModel、PropertyModel、ActionModel 和 
ParameterModel 对 象 来 填充 ApplicationModel， 以 摘 
述 友 现 的 控制 占 。 





一 些 约定 是 显 式 的 ， 例 如 将 Controller 从 控制 右 
的 类 名 中 移 除 ， 用 来 设置 ControllerModel 对 象 的 


ControllerName 属 性 。 这 个 约定 意味 着 定义 名 为 
HomeController 的 类 ， 但 在 URE 片段 中 使 用 Home 来 


定位 。 


其 他 约定 是 隐 式 的 ， 例 如 关 用 来 创建 控制 硕 ， 
方法 用 来 创建 操作 。 大 多 数 MVC 开 及 人 员 将 这 些 约 
定 视 为 理所当然 ， 但 是 实际 上 ， 应 用 程序 模型 的 各 
AD TEL FB PY AARE o 


前 面 的 革 节 摘 述 了 用 来 改变 MVC 工 作 方 式 的 
特性 ， 它 们 实际 上 是 模型 约定 。 表 31-8 介 绍 了 这 些 


























允许 显 式 指定 ActionModel 的 ActionName 属 性 ， 而 不 是 从 方法 名 
NonController | 防止 类 被 用 于 创建 ControllerModel 对 象 

















NonAction 防止 方法 被 用 于 创建 ActionModel 对 象 








代码 清单 31-7 使 用 ActionName 特 性 修改 了 创建 
于 HomeController 类 中 的 List 方 法 的 操作 名 称 。 


代码 清单 31-7 在 Controllers 文 件 夹 下 的 HomeController.cs 中 定 
制 应 用 程序 模型 





using ConventionsAndConstraints.Models; 
using Microsoft.AspNetCore.Mvc; 


namespace ConventionsAndConstraints.Controllers { 
public class HomeController : Controller { 
public IActionResult Index() => View("Result", 


new Result { 


Controller = nameof(HomeController), 
Action = nameof (Index) 


}); 


[ActionName("Details")] 


public IActionResult List() => View("Result", n 
ew Result { 


Controller = nameof(HomeController), 
Action = nameof(List) 





名 称 Details 将 被 用 于 创建 操作 ， 并 蔡 换 默认 的 
名 称 List。 可 以 通过 局 动 应 用 程序 并 访 
问 /Home/Details 来 全 看 效果 ， 如 图 31-2 所 示 ， 请 求 
被 List 方 法 处 理 。 














图 31-2 ”定制 应 用 程序 模型 


31.2.2 ”理解 模型 约定 角色 
表 31-8 描 述 的 特性 允许 对 应 用 程序 模型 进行 基 


本 的 变更 ， 但 是 范围 有 限 。 对 于 更 实质 的 定制 ， 需 
要 使 用 模型 约定 。 

来 目 表 31-8 的 特性 允许 在 应 用 程序 模型 对 象 创 
建 之 前 指定 变更 ， 例 如 缆 关 操作 的 名 称 。 相 比 之 








下 ， 模 型 约定 允许 在 模型 对 象 创建 之 后 更 新 应 用 程 
序 模型 ， 从 而 允许 进行 更 广泛 的 更 新 。 有 4 种 类 型 
的 模型 约定 ， 每 种 通过 不 同 的 接口 进行 定义 ， 如 表 
31-9 上 所 示 。 








表 31-9 ”应 用 程序 模型 约定 接口 




















IApplicationModelConvention ”| 应 用 模型 约定 到 ApplicationModel 对 象 
IControllerModelConvention 应 用 模型 约定 到 应 用 程序 模型 的 ControllerModel 对 象 











IActionModelConvention 应 用 模型 约定 到 应 用 程序 模型 的 ActionModel 对 象 
IParameterModelConvention 应 用 模型 约定 到 应 用 程序 模型 的 ParameterModel 对 象 


这 4 种 接口 都 以 相同 的 方式 工作 ， 只 是 它们 修 
改 的 应 用 程序 模型 层面 不 同 。 人 例如， 下面 是 
IControllerModel- Convention 接 口 的 定义 : 


namespace Microsoft.AspNetCore.Mvc.ApplicationModels { 











public interface IControllerModelConvention { 


void Apply(ControllerModel controller) ; 


} 
} 





通过 调用 Apply 方 法 可 提供 对 应 用 程序 模型 约 
定 的 目标 修改 ControllerModel 的 机 会 ， 作 为 方法 的 
参数 接收 。 其 他 接口 也 定义 了 Apply 方 法 ， 并 且 每 
个 都 接收 对 应 类 型 的 模型 对 象 ， 比 如 
IActionModelConvention 接 口 接收 ActionModel 对 
象 ， 而 IParameterModelConvention 接 口 接收 
ParameterModel 对 象 。 


31.2.3 i tte AY A E 
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用 ， 这 样 可 以 很 容易 设置 应 用 更 改 的 范围 。 作 为 泪 
示 ， 创 建 Infrastructure 文件 夹 并 添加 名 为 
ActionNamePrefixAttribute.cs 的 类 文件 ， 用 它 定 义 代 





码 清单 31-8 所 示 的 类 。 


代码 清单 31-8 Infrastructure XFX F H 
ActionNamePrefixAttribute.cs 文 件 的 内 容 


using System; 
using Microsoft.AspNetCore.Mvc.ApplicationModels; 


namespace ConventionsAndConstraints.Infrastructure { 


[AttributeUsage(AttributeTargets.Method, AllowMulti 
ple = false) ] 
public class ActionNamePrefixAttribute : Attribute, 
TActionModelConvention { 
private string namePrefix; 


public ActionNamePrefixAttribute(string prefix) 


namePrefix = prefix; 


} 


public void Apply(ActionModel action) { 
action.ActionName = namePrefix + action.Act 
ionName; 
} 
} 





ActionNamePrefixAttribute22 Jk Æ H Attribute% 


并 实现 了 IActionModelConvention 接 口 。 


ActionNamePrefix- Attribute 类 的 构造 函数 接受 用 作 
前 级 的 字符 串 ， 访 字符 串 用 于 修改 Apply 方 法 接收 
的 ActionModel 对 象 的 ActionName 属 性 。 


人 
提 示 


这 里 限制 了 ActionNamePrefix 特 性 的 使 用 ， 它 
只 能 应 用 于 方法 。 当 以 特性 的 方式 应 用 模型 约定 
时 ， 控 制 器 约定 只 有 当 作 用 于 关 时 才能 生效 ， 操 作 
约定 只 有 当 作 用 于 方法 时 才能 生效 ， 参 数 约定 只 有 
当 作 用 于 参数 才能 生效 。 在 错误 的 级 别 应 用 约定 会 
被 简单 地 忽略 而 不 产生 任何 错误 。 为 避免 混 消 ， 可 
使 用 AttributeUsage 来 限制 创建 的 特性 。 





代码 清单 31-9 将 模型 约定 应 用 到 了 Home 控 制 
AHIRET IRE. 


ARI 31-9 ÆControllers X44% F #JHomeController.cs X44 
中 应 用 模型 约定 


using ConventionsAndConstraints.Models; 
using Microsoft.AspNetCore.Mvc; 
using ConventionsAndConstraints. Infrastructure; 


namespace ConventionsAndConstraints.Controllers { 
public class HomeController : Controller { 


public IActionResult Index() => View("Result", 
new Result { 
Controller = nameof(HomeController), 
Action = nameof( Index) 


}); 


[ActionNamePrefix("Do")] 


public IActionResult List() => View("Result", n 
ew Result { 


Controller = nameof(HomeController), 
Action = nameof(List) 





当 MVC 执 行 发 现 过 程 的 时 候 ， 将 创建 用 于 描 


述 List 方 法 的 ActionModel 对 象 ， 检 测 
ActionNamePrefix 并 调用 Apply 方 法 。 可 以 通过 运行 
应 用 程序 并 访问 /Home/DoList 来 查看 效果 ， 在 默认 
约定 下 ， 定 位 到 List 方 法 的 URL 已 经 被 葵 换 了 ， 如 
图 31-3 所 示 。 





Controller: HomeController 


Action: List 


图 31-3 ”应 用 模型 约定 
使 用 约定 琴 加 或 删除 模型 


使 用 模型 约定 的 一 种 奇怪 方式 是 阻止 在 应 用 程 
序 模型 中 添加 或 删除 对 象 。 例 如 ， 假 设 要 创建 一 个 
约定 ， 可 以 通过 两 种 不 同 的 操作 来 访问 茶 些 方法 。 
为 了 濡 示 ， 在 Infrastructure 文件 严 中 创建 名 为 
AddActionAttribute.cs 的 类 文件 ， 并 用 它 定 义 代码 清 











单 31-10 所 示 的 类 。 


代码 清单 31-10 Infrastructure X4% F HJ AddActionAttribute.cs 
文件 的 内 容 


using System; 
using Microsoft.AspNetCore.Mvc.ApplicationModels; 


namespace ConventionsAndConstraints.Infrastructure { 


[AttributeUsage(AttributeTargets.Method, AllowMulti 
ple = true) ] 
public class AddActionAttribute : Attribute, IActio 
nModelConvention { 
private string additionalName; 


public AddActionAttribute(string name) { 
additionalName = name; 
} 


public void Apply(ActionModel action) { 


action.Controller.Actions.Add(new ActionMod 
el(action) { 


ActionName = additionalName 





a) 
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制 现 有 对 象 并 修改 新 对 象 的 ActionName 属 性 。 可 通 
过 ActionModel.Controller 属 性 将 新 的 ActionModel 湛 
加 到 控制 器 的 操作 集合 中 。 在 代码 清单 31-11 中 ， 

可 以 看 到 如 何 将 模型 约定 应 用 于 Home 控 制 右 。 


代码 清单 31-11 在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 应 用 模型 约定 





using ConventionsAndConstraints.Models; 
using Microsoft.AspNetCore.Mvc; 
using ConventionsAndConstraints. Infrastructure; 


namespace ConventionsAndConstraints.Controllers { 
public class HomeController : Controller { 


public IActionResult Index() => View("Result", 
new Result { 
Controller = nameof(HomeController), 
Action = nameof (Index) 


}); 


[AddAction("Details")] 
public IActionResult List() => View("Result", n 
ew Result { 
Controller = nameof(HomeController), 
Action = nameof(List) 


}); 


| 
启动 应 用 程序 ，MVC 将 开始 发 现 过 程 并 报告 
如 下 错误 : 


InvalidOperationException: Collection was modified; enu 
meration operation may not execute. 


当 操 作 集 合 被 发 现 过 程 枚 举 时 ， 模 型 约定 试图 
修改 action 模 型 对 象 的 集合 ， 从 而 导致 异 间 。 为 避 
免 错 误 ， 可 采用 不 同 的 方法 ， 如 代码 清单 31-12 上 所 
二 





代码 清单 31-12 在 Infrastructure 文 件 夹 下 的 
AddActionAttribute.cs 文 件 中 创建 安全 的 模型 约定 





using System; 
using Microsoft.AspNetCore.Mvc.ApplicationModels; 
using System.Ling; 


namespace ConventionsAndConstraints.Infrastructure { 


[AttributeUsage(AttributeTargets.Method, AllowMulti 
ple = true)] 
public class AddActionAttribute : Attribute { 


public string AdditionalName { get; } 


public AddActionAttribute(string name) { 
AdditionalName = name; 


} 
} 


[AttributeUsage(AttributeTargets.Class, AllowMultip 
le = false)] 
public class AdditionalActionsAttribute : Attribute, 


IControllerModelConvention { 


public void Apply(ControllerModel controller) { 
var actions = controller.Actions 
-Select(a => new { 
Action = a, 
Names = a.Attributes.Select(attr => 
(attr as AddActionAttribute)?.A 
dditionalName ) 


}); 


foreach (var item in actions.ToList()) { 
foreach (string name in item.Names) { 
controller.Actions.Add(new ActionMo 
del(item.Action) { 


ActionName = name 


}); 





在 action 模 型 约定 中 ， 不 能 修改 控制 器 相关 的 
操作 方法 集合 。 但 是 ， 仍 然 需要 以 某 种 方式 表达 要 
做 的 修改 。 因 此 ， 将 AddActionAttribute 作 为 特性 而 
不 是 模型 约定 使 用 。 


你 可 以 在 控制 器 的 模型 约定 中 修改 操作 方法 集 
合 ， 这 就 是 为 什么 创建 AdditionalActionsAttribute 
类 。Apply 方 法 使 用 LINQ 来 定位 使 用 了 
AddActionAttribute 特 性 的 方法 并 使 用 指定 的 名 称 创 
建新 的 ActionModel 对 象 。 








对 于 AdditionalActionsAttribute 类 ， 最 重要 的 部 
分 是 在 LINQ 奏 询 结果 上 调用 ToList 方 法 : 


foreach (var item in actions.ToList()) { 


ToList 方 法 强制 对 LINQ 查 询 结果 求 值 并 用 结果 
生成 一 个 新 的 集合 。 这 意味 着 foreach 循 环 将 在 另外 


的 对 象 集 上 枚 举 。 石 没有 ToList 调 用 ， 束 会 收 到 与 
代码 消音 31-12 相 同 的 错误 ; AEA ToList AA, Wè 
能 创建 新 的 action 模 型 对 象 。 代 码 清单 31-13 展 示 了 
如 何 将 修改 后 的 特性 应 用 于 Home 控 制 右 。 





代码 清单 31-13 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 应 用 修改 后 的 模型 约定 








using ConventionsAndConstraints.Models; 
using Microsoft.AspNetCore.Mvc; 
using ConventionsAndConstraints. Infrastructure; 


namespace ConventionsAndConstraints.Controllers { 


[ AdditionalActions ] 
public class HomeController : Controller { 


public IActionResult Index() => View("Result", 
new Result { 
Controller = nameof(HomeController), 
Action = nameof( Index) 


}); 


[AddAction("Details")] 
public IActionResult List() => View("Result", n 
ew Result { 
Controller = nameof(HomeController), 
Action = nameof(List) 


}); 


} 


可 以 通过 局 动 应 用 程序 并 访问 /Home/Details 
和 /Home/List 来 便 看 修改 后 的 模型 约定 效 末 。 如 图 
31-4 所 示 ， 模 型 约定 添加 了 由 List 方 法 处 理 的 新 操 
作 ， 补 元 了 默认 创建 的 操作 模型 。 





Controller: 


图 31-4 创建 新 的 操作 模型 
31.2.4 理解 模型 约定 的 执行 顺序 


模型 约定 将 以 特定 的 次 序 应 用 ， 从 最 大 范围 开 
始 : 首先 应 用 控制 右 模 型 约定 ， 然 后 应 用 操作 模型 
约定 ， 最 后 应 用 参数 模型 约定 。 为 了 演示 ， 将 前 面 
几 个 示例 中 创建 的 自 定义 模型 约定 应 用 于 
HomeController 类 的 List 方 法 ， 如 代码 清单 31-14 所 








人 小。 


代码 清单 31-14 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 应 用 多 个 模型 约定 





using ConventionsAndConstraints.Models; 
using Microsoft.AspNetCore.Mvc; 
using ConventionsAndConstraints. Infrastructure; 


namespace ConventionsAndConstraints.Controllers { 


[AdditionalActions ] 
public class HomeController : Controller { 


public IActionResult Index() => View("Result", 
new Result { 
Controller = nameof(HomeController), 
Action = nameof( Index) 


}); 


[ActionNamePrefix("Do")] 
[AddAction("Details")] 
public IActionResult List() => View("Result", n 
ew Result { 
Controller = nameof(HomeController), 
Action = nameof(List) 
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AdditionalActions 特 性 ， 并 创建 名 为 Details 的 操作 。 
然后 ， 应 用 作为 操作 模型 约定 的 
ActionNamePrefix， 将 Do 前 级 应 用 于 操作 方法 关联 
的 操作 。 结 果 导 致 List 方 法 实现 了 两 个 操作 一 一 
DoList 和 DoDetails， 它 们 可 以 使 用 URL 地 

址 /Home/DoList 和 /Home/DoDetails 访 问 ， 如 图 31-5 
所 示 。 





Pe 
€ C |© localhost 
[M Result x 
Controller: HomeController 
e C | O localhost:5 j| } 
Action: 
Controller: HomeController 
n 


图 31-5 “多 个 模型 约定 的 执行 效果 
31.2.5 ”创建 全 局 模型 约定 


如 果 需 要 更 改 稚 认 模 型 约定 ， 那 么 可 能 必须 为 
应 用 程序 中 的 每 个 控制 攻 、 操 作 或 参数 执行 更 改换 
作 。 如 末 是 这 种 情况 ， 那 么 可 以 创建 全 局 模型 约 


定 ， 而 不 必 将 特性 一 一 应 用 于 每 个 控制 从 类 。 全 局 
模型 约定 在 Startup 类 中 配置 ， 如 代码 清单 31-15 所 
不 。 


代码 清单 31-15 ”在 ConventionsAndConstraints 文 件 夹 下 的 
Startup.cs 文 件 中 创建 全 局 过 滤器 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using ConventionsAndConstraints. Infrastructure; 


namespace ConventionsAndConstraints { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc().AddMvcOptions(options => { 


options.Conventions.Add(new ActionNameP 
refixAttribute("Do")); 

options.Conventions.Add(new AdditionalA 
ctionsAttribute()); 


}); 


} 


public void Configure(IApplicationBuilder app, 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage(); 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute(); 





由 AddMvcOptions 扩 展 方法 接收 的 MvcOptions 
对 象 定 义 了 Conventions 属 性 。 这 个 属性 将 返回 用 于 
湛 加 模型 约定 对 象 的 列表 集合 ， 其 中 的 列表 可 全 局 
应 用 两 个 自 定义 模型 约定 。 这 意味 着 所 有 的 操作 名 
称 将 以 Do 为 前 级 ， 并 将 检查 所 有 的 AddAction 特 
性 。 由 于 这 些 模型 约定 将 被 全 局 应 用 ， 因 此 从 
HomeController 关 中 将 它们 删除 ， 如 代码 清单 31-16 
所 示 。 











代码 清单 31-16 ”从 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 删除 模型 约定 


using ConventionsAndConstraints.Models; 
using Microsoft.AspNetCore.Mvc; 
using ConventionsAndConstraints. Infrastructure; 


namespace ConventionsAndConstraints.Controllers { 


//[AdditionalActions ] 
public class HomeController : Controller { 


public IActionResult Index() => View("Result", 
new Result { 
Controller = nameof(HomeController), 
Action = nameof( Index) 


}); 


//[ActionNamePrefix("Do")] 
[AddAction("Details")] 
public IActionResult List() => View("Result", n 
ew Result { 
Controller = nameof(HomeController), 
Action = nameof(List) 








在 模型 约定 作用 于 闫 之 前 ， 应 用 全 局 模型 给 
定 。 如 条 有 多 个 全 局 模型 约定 ， 那 么 它们 将 按照 注 
册 的 顺序 应 用 ， 而 不 考 碟 类 型 。 在 控制 部 模 型 约定 
之 前 注册 操作 模型 约定 ， 这 意味 看 在 将 





ActionNamePrefixAttribute 约 定 应 用 于 所 有 操作 之 
后 ， 通 过 AddAction 特 性 指定 的 Details 操 作 才 被 创 
建 。 因 此 ， enti 了 两 个 操作 一 一 DoList 和 和 
Details， 它 们 可 以 通过 URL 地 址 /Home/DoList 

和 /Home/Details 进 行 访 问 ， 如 图 31-6 所 示 。 











图 31-6 全 局 模型 约定 的 执行 结果 
31.3 ”使 用 操作 约束 


amis 约 anaes 了 操作 方法 是 否 适 合用 来 处 理 特 
定 请 求 ， 这 可 能 导致 你 认为 操作 约束 闫 似 于 第 19 章 
mide TEAS o 








实际 上 ， 操 作 约 束 更 受 限 。 当 MVC 接 收 到 


HTTP 请 求 时 ， 将 通过 一 个 选择 过 程 来 识别 用 于 处 

理 HTTP 请 求 的 操作 方法 。 如 果 有 多 个 操作 方法 可 

以 处 理 请 求 ， 那 么 MVC 需 要 使 用 一 些 手段 来 决定 使 
用 哪个 操作 方法 ， 这 就 是 使 用 操作 约束 的 原因 。 表 
31-10 提 供 操 作 约 束 的 背景 。 








表 31-10 ”操作 约束 的 背景 


它们 是 什 
A? 



































操作 约束 是 MVC 用 来 确定 HTTP 请 求 是 否 可 以 由 特定 操作 方法 处 理 的 > 






































它们 为 什么 | 如 果 有 两 个 或 更 多 个 操作 方法 可 以 处 理 某 个 请 求 ， 那 么 MVC 需 要 使 用 一 些 
有 用 ? 段 来 决定 使 用 哪个 操作 方法 ， 操 作 约 束 用 来 提供 这 些 信息 










































































操作 约束 通过 特性 来 使 用 ， 这 允许 它们 在 整个 应 用 程序 中 重用 ， 且 意味 着 确 
定 操作 是 否 应 该 处 理 请 求 的 逻辑 不 必 在 操作 方法 中 定义 














































































































有 什么 陷阱 | 操作 约束 可 以 被 广泛 应 用 ， 并 阻止 请 求 被 任何 适当 的 操作 方法 处 理 ， 














制 中 ?| 客户 端 发 送 无 用 的 404 - Not Found 响 应 














如 果 需 要 在 特定 情况 下 限制 对 操作 的 访问 ， 那 么 过 滤器 更 为 有 用 ， 
向 客户 端 以 便 显示 有 用 的 错误 页 面 




































































31.3.1 准备 示例 项 目 


操作 约束 的 目的 是 帮助 MVC 在 两 个 或 多 个 可 
以 用 于 处 理 请 求 的 操作 方法 之 间 进 行 选择 。 代 码 清 
单 31-17 在 Home 控 制 器 中 添加 了 另 一 个 新 的 操作 方 
法 。 





代码 清单 31-17 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 创建 两 个 合适 的 操作 方法 





using ConventionsAndConstraints.Models; 
using Microsoft.AspNetCore.Mvc; 
using ConventionsAndConstraints. Infrastructure; 


namespace ConventionsAndConstraints.Controllers { 


//([AdditionalActions ] 
public class HomeController : Controller { 


public IActionResult Index() => View("Result", 


new Result { 
Controller = nameof(HomeController), 


Action = nameof (Index) 


}); 


[ActionName("Index")] 
public IActionResult Other() => View("Result", 


new Result { 


Controller = nameof(HomeController), 
Action = nameof (Other) 


}); 


//[ActionNamePrefix("Do" ) ] 
[AddAction("Details") ] 
public IActionResult List() => View("Result", n 
ew Result { 
Controller = nameof(HomeController), 
Action = nameof(List) 





以 上 代码 添加 了 一 个 新 的 名 为 Other 的 操作 方 
法 并 应 用 ActionName 特 性 以 便 处 理 为 名 为 Index 的 
操作 。 更 新 Startup 类 以 删除 本 和 章 前 面 的 全 局 模型 约 
定 ， 如 代码 清单 31-18 所 示 。 


代码 清单 31-18 ”在 ConventionsAndConstraints 文 件 夹 下 的 
Startup.cs 文 件 中 删除 全 局 模型 约定 





using System; 

using System.Collections.Generic; 
using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 
using Microsoft.AspNetCore.Hosting; 
using Microsoft.AspNetCore.Http; 


using Microsoft.Extensions.DependencyInjection; 
using ConventionsAndConstraints. Infrastructure; 


namespace ConventionsAndConstraints { 


public class Startup { 
public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddMvc().AddMvcOptions(options => 


{ 
//options.Conventions.Add(new ActionNam 
ePrefixAttribute("Do") ); 
//options.Conventions.Add(new Additiona 
lActionsAttribute() ); 
}); 
} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 





这 意味 着 Home 控 制 器 中 存在 两 个 名 为 Index 的 
操作 ， 如 果 运 行 应 用 ， 将 看 到 图 31-7 所 示 的 错误 消 
尽 ， 指 出 MVC 不 知道 应 用 使 用 哪个 操作 方法 。 














cancidates) 


图 31-7 错误 消息 
以 上 是 错 mak suv 的 相关 内 容 : 


AmbiguousActionException: Multiple actions matched. The 
following actions matched route 
data and had all constraints satisfied: 


ConventionsAndConstraints.Controllers.HomeController.In 
dex 


ConventionsAndConstraints.Controllers.HomeController.Ot 
her 





31.3.2 ”操作 约束 的 作用 


操作 约束 用 来 告诉 MVC 是 否 可 以 使 用 操作 方 
法 处 理 请 求 和 实现 IActionConstraint 接 口 ， 这 个 接口 
的 定义 如 下 : 


namespace Microsoft.AspNetCore.Mvc.ActionConstraints { 


public interface IActionConstraint : IActionConstra 
intMetadata { 


int Order { get; } 


bool Accept(ActionConstraintContext context) ; 


} 


} 








MVC 在 经 过 选择 操作 方法 来 处 理 请 求 的 过 程 
后 ， 将 检查 是 否 存 在 与 之 关联 的 约束 。 如 果 有 ， 它 
们 将 按照 Order 属 性 的 全 依次 组 织 ， 并 且 依 次 调用 
每 个 约束 的 Accept 方 法 。 只 要 任何 约束 的 Accept 方 
法 返回 false，MVC 就 知道 操作 方法 不 能 用 于 处 理 当 
前 请 求 。 








he 示 


IActionConstraint 接 口 派生 自 
IActionConstraintMetadata， 后 者 是 没有 定义 成 员 的 
接口 ， 并 不 直接 使 用 。 当 创建 和 目 定 义 约 束 时 ， 应 当 
使 用 IActionConstraint 接 口 ， 当 期 望 创 建 有 依赖 要 处 
理 的 约束 时 ， 应 当 使 用 IActionConstraintFactory 接 
Els 


为 了 有 助 于 操作 约束 做 出 决定 ，MVC 提 供 了 
ActionConstraintContext 实 例 作 为 上 下 文 数 据 ， 
Action- ConstraintContext 类 定义 的 属性 如 表 31-11 所 
A 


表 31-11 ActionConstraintContext 类 定义 的 属性 


" k 





























返回 ActionSelectorCandidate 对 象 列表 ， 描 述 MVC 用 于 处 理 当 前 请 求 的 候 
Candidates ees 
选 操作 方法 列表 




















CurrentCandidate | 返回 ActionSelectorCandidate 对 象 ， 描 述 约束 当前 正在 请 求 评 估 的 操作 方 



































返回 RouteContext 对 象 ， 提 供 路 由 数据 〈 通 过 RouteData 属 性 ) 以 及 HTTP 











RouteContext aa 
请 求 〈 通 过 HttpContext 属 性 ) 














31.3.3 ”创建 操作 约束 


最 音 见 的 操作 约束 是 确认 请 求 符 合 某 些 策 略 ， 
比如 提供 特定 的 HTTP 请 求 涉 。 为 了 演示 此 种 类 型 
的 操作 约束 ， 在 示例 项 目的 Infrastructure 文 件 夹 中 
添加 名 为 UserAgentAttribute.cs 的 类 文件 ， 用 它 定 义 
代码 清单 31-19 所 示 的 类 。 


代码 清单 31-19 Infrastructure XAFI R F ÉI 
UserAgentAttribute.cs 文 件 的 内 容 





using System; 
using System.Ling; 
using Microsoft.AspNetCore.Mvc.ActionConstraints; 


namespace ConventionsAndConstraints.Infrastructure { 


public class UserAgentAttribute : Attribute, IActio 
nConstraint { 


private string substring; 

public UserAgentAttribute(string sub) { 
substring = sub. ToLower(); 

} 

public int Order { get; set; } = 9; 


public bool Accept(ActionConstraintContext cont 


ext) { 
return context. RouteContext.HttpContext 
.Request.Headers[ "User-Agent" | 
.Any(h => h.ToLower().Contains(substrin 
g)); 





以 上 操作 约束 用 于 在 UserAgent 请 求 头 不 包含 





特定 字符 串 的 时 候 ， 阻 止 匹 配 的 操作 方法 处 理 请 

求 。 在 Accept 方 法 中 ， 从 HttpContext 对 象 中 获取 请 
求 涉 ， 然 后 使 用 LINQ 来 检查 其 中 之 一 是 否 包含 通 
过 构造 疯 数 接收 的 子 串 。 





Wo 
v> =z 
ve Je. 


在 实际 的 应 用 程序 中 不 要 基于 User-Agent 头 来 
Walid, KANG RAN BARS RSA. Bil 
如 ， 在 编写 本 书 时 ，Microsoft Edge 浏 览 器 发 送 的 
User-Agent 请 求 头 中 包含 了 Android、Apple、 
Chrome 和 Safari， 使 得 很 容易 误 认 为 其 他 的 浏览 
器 。 更 稳健 的 方式 是 在 应 用 ee Oe a 
如 Modernizr) 来 检测 浏览 








代码 清单 31-20 为 HomeController 类 中 的 一 个 方 
法 应 用 了 操作 约束 。 


代码 清单 31-20 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 应 用 操作 约束 


using ConventionsAndConstraints.Models; 
using Microsoft.AspNetCore.Mvc; 
using ConventionsAndConstraints. Infrastructure; 


namespace ConventionsAndConstraints.Controllers { 


//{AdditionalActions ] 
public class HomeController : Controller { 


public IActionResult Index() => View("Result", 
new Result { 
Controller = nameof(HomeController), 
Action = nameof( Index) 


}); 


[ActionName("Index")] 
[UserAgent("Edge")] 
public IActionResult Other() => View("Result", 
new Result { 
Controller = nameof(HomeController), 
Action = nameof (Other) 


}); 


//[ActionNamePrefix("Do")] 
[AddAction("Details")] 
public IActionResult List() => View("Result", n 
ew Result { 
Controller = nameof(HomeController), 
Action = nameof(List) 





为 Other 操作 方法 应 用 这 个 特性 ， 并 指定 如 果 


请 求 的 User-Agent 请 求 头 中 没有 包 舍 Edge， 就 不 接 
收 请 求 。 


局 动 应 用 程序 ， 分 别 使 用 Google Chrome 和 
Microsoft Edge 浏 览 器 访问 /Home/Index， 你 将 看 到 
不 同 的 处 理 结 末 ， 如 图 31-8 所 示 。 





Ares O 
¢ CS | © locathost:5927¢ B® © Ø Result 
Controller: Homecontroller & O | localhost yel = UF 
Action: = Index 
Controller: 


Action: 


图 31-8 ”操作 约束 的 使 用 效果 


理解 操作 方法 的 约束 效果 





前 面 的 示例 揭示 了 使 用 操作 约束 的 如 下 方面 : 
对 于 给 定 的 请 求 ， 带 有 Accept 方 法 且 返 回 true 的 应 
用 了 操作 约束 的 操作 方法 优先 于 没有 应 用 操作 约束 





的 操作 方法 。 


Home 控 制 器 中 有 两 个 名 为 Index 的 操作 ， 分 别 
由 Index 和 Other 操 作 方 法 创建 ， 它 们 都 可 以 处 理 带 
有 请 求 头 User-Agent 且 信 为 Edge 的 请 求 。Other 操 作 
方法 用 来 处 理 来 目 Edge 浏 览 器 的 请 求 这 是 由 于 为 之 
应 用 了 操作 约束 ， 并 且 Accept 方 法 返回 true。 理 念 
就 是 ， 市 接收 请 求 的 操作 约束 的 操作 方法 总 是 优先 
于 没有 操作 约束 的 操作 方法 。 





创建 比较 用 的 操作 约束 


通过 ActionConstraintContext 对 象 的 Candidates 
和 CurrentCandidate 属 性 ， 操 作 约 束 提供 了 处 理 请 求 
的 其 他 候选 操作 方法 的 主 情 。 每 个 潜在 的 匹配 可 使 
用 ActionSelectorCandidate 实 例 来 描述 ， 用 到 的 属性 


如 表 31-12 所 示 。 


表 31-12 ActionSelectorCandidate 类 定义 的 属性 


- 









































到 候选 操作 方法 的 IActionConstraint 约 束 列表 








ActionDescriptor 类 用 于 通过 表 31-13 所 示 的 属 
性 描述 操作 方法 ， 与 其 他 上 下 文 对 象 提 供 的 内 容 类 
似 。 


表 31-13 ”ActionDescriptor 类 定义 的 属性 


























操作 方法 的 名 称 






































来 限制 如 何 路 由 到 操作 方法 的 IList<IRouteConstraintProvider> 列 表 
返回 操作 方法 参数 描述 的 IList<PropertyModel> 列 表 





























ActionConstraints | 返回 操作 方法 的 约束 列表 IList<IActionConstraintMetadata> 





操作 约束 可 以 检查 候选 的 操作 方法 并 洞察 如 何 
以 及 在 哪里 应 用 ， 还 可 以 微调 它们 如 何 工作 。 作 为 
示例 ， 考 虑 代码 清单 31-21 中 应 用 到 Home 控 制 器 的 
操作 约束 。 


代码 清单 31-21 ”在 Controllers 文 件 夹 下 的 HomeController.cs 文 
件 中 为 控制 右 应 用 操作 约束 





using ConventionsAndConstraints.Models; 
using Microsoft.AspNetCore.Mvc; 
using ConventionsAndConstraints. Infrastructure; 


namespace ConventionsAndConstraints.Controllers { 
public class HomeController : Controller { 


public IActionResult Index() => View("Result", 
new Result { 
Controller = nameof(HomeController), 
Action = nameof (Index) 


}); 


[ActionName("Index")] 

[UserAgent("Edge")] 

public IActionResult Other() => View("Result", 
new Result { 


Controller = nameof(HomeController), 
Action = nameof(Other) 


}); 


[UserAgent("Edge")] 
public IActionResult List() => View("Result", n 
ew Result { 
Controller = nameof(HomeController), 
Action = nameof(List) 











这 里 仅 为 名 为 List 的 操作 方法 应 用 了 操作 约 
束 ， 这 意味 着 仅 在 请 求 头 User-Agent 中 包含 Edge 的 
请 求 可 使 用 这 个 操作 方法 处 理 。 例 如 ， 如 果 使 用 
Google Chrome 发 出 请 求 ， 将 收 到 404 - Not Found! 
Mo 








这 没什么 用 ， 因 为 用 户 不 知道 为 什么 收 到 错 
误 ， 也 没有 说 明 性 的 文本 来 建议 使 用 其 他 的 浏览 砷 
符 代 Google Chrome。 在 控制 处 理 请 求 的 操作 方法 
的 选择 时 ， 操 作 约 束 很 有 用 ; 使 用 过 滤器 将 允许 把 
客户 重 定 同 到 有 错误 说 明 的 页 面 ， 这 才 是 更 实用 的 








响应 。 


为 了 处 理 这 个 问题 ， 更 新 UserAgentAttribute 
类 ， 以 便 在 只 有 一 个 候选 操作 方法 的 时 候 不 拒绝 请 
求 ， 如 代码 清单 31-22 所 示 。 


代码 清单 31-22 ”在 mmfrastructure 文 件 夹 下 的 
UserAgentAttribute.cs 文 件 中 检查 其 他 候选 操作 方法 





using System; 

using System.Ling; 

using Microsoft.AspNetCore.Mvc.ActionConstraints; 
namespace ConventionsAndConstraints.Infrastructure { 


public class UserAgentAttribute : Attribute, IActio 
nConstraint { 
private string substring; 


public UserAgentAttribute(string sub) { 
substring = sub.ToLower(); 


} 
public int Order { get; set; } = ð; 


public bool Accept(ActionConstraintContext cont 
ext) { 
return context. RouteContext.HttpContext 
.Request.Headers[ "User-Agent" ] 
.Any(h => h.ToLower().Contains(subs 


|| context.Candidates.Count() == 1; 








附加 的 LINQ 碍 询 将 检查 CurrentCandidate 返 回 
的 候选 操作 方法 是 否 为 Candidates 属 性 返回 的 集合 
中 的 唯一 元 素 。 如 果 是 ， 那 么 操作 约束 就 知道 MVC 
没有 其 他 a 允许 请 求 。 使 用 Google 
Chrome 浏 贤 右 运行 应 用 程序 并 请 求 URL 地 
址 /Home/List 来 查看 效果 。 即 使 通过 Google Chrome 
及 送 请 求 的 User-Agent 请 求 关 中 没有 包含 Edge， 的 
束 类 也 将 因为 检测 到 没有 其 他 的 候选 操作 方法 而 允 
许 请 求 被 处 理 。 














31.3.4 ”在 操作 约束 中 处 理 依赖 





当 需 要 通过 service provider 在 操作 约束 中 处 理 
依赖 的 时 ji ， 使 用 IActionConstraintFactory 接 口 。 如 
第 18 章 所 示 ， 下 面 是 这 个 接口 的 定义 : 


using System; 


namespace Microsoft.AspNetCore.Mvc.ActionConstraints { 


public interface IActionConstraintFactory : IAction 
ConstraintMetadata { 


TActionConstraint CreateInstance(IServiceProvid 
er services); 


bool IsReusable { get; } 





CreateInstance 方 法 将 被 调用 以 创建 操作 约束 ， 
ISReusable 属 性 用 来 指示 通过 CreateInstance 方 法 创 
建 的 对 象 是 否 可 以 用 于 多 个 请 求 。 








为 了 演示 这 个 接口 的 使 用 ， 要 用 到 依赖 关系 。 
为 此 ， 在 Infrastructure 文 件 夹 中 添加 名 为 
UserAgentComparer.cs 的 类 文件 ， 并 用 它 定义 代码 
清单 31-23 所 示 的 类 。 


代码 清单 31-23 Infrastructure XAF H F H 
UserAgentComparer.cs 文 件 的 内 容 


using System.Ling; 
using Microsoft.AspNetCore.Http; 


namespace ConventionsAndConstraints.Infrastructure { 
public class UserAgentComparer { 


public bool ContainsString(HttpRequest request, 


string agent) { 
string searchTerm = agent.ToLower() ; 
return request.Headers[ "User-Agent" | 
.Any(h => h.ToLower().Contains(searchTe 





UserAgentComparer 类 定义 了 一 个 用 于 在 User- 
Agent 请 求 头 中 得 询 字 符 串 的 方法 。 功 能 与 前 面 的 
示例 相同 ， 但 是 打包 成 单独 的 类 ， 以 便 可 以 使 用 
service provider 来 管理 生命 周期 ， 如 代码 清单 31-24 
所 示 。 





代码 清单 31-24 在 ConventionsAndConstraints 文 件 夹 下 的 
Startup.cs 文 件 中 为 service provider 注 册 类 型 


using System; 


using System.Collections.Generic; 

using System.Ling; 

using System. Threading. Tasks; 

using Microsoft.AspNetCore. Builder; 

using Microsoft.AspNetCore.Hosting; 

using Microsoft.AspNetCore.Http; 

using Microsoft.Extensions.DependencyInjection; 
using ConventionsAndConstraints. Infrastructure; 


namespace ConventionsAndConstraints { 
public class Startup { 


public void ConfigureServices(IServiceCollectio 
n services) { 
services.AddSingleton<UserAgentComparer>(); 
services.AddMvc().AddMvcOptions(options => 


{ 
//options.Conventions.Add(new ActionNam 
ePrefixAttribute("Do") ) ; 
//options.Conventions.Add(new Additiona 
lActionsAttribute() ) ; 
})3 
} 


public void Configure(IApplicationBuilder app， 
IHostingEnvironment env) { 
app.UseStatusCodePages(); 
app.UseDeveloperExceptionPage() ; 
app.UseStaticFiles(); 
app.UseMvcWithDefaultRoute() ; 





以 上 代码 选择 了 单 例 生命 周期 ， 这 意味 兰 
UserAgentComparer 类 只 a 。 代 码 清 单 31- 
25 更 新 了 ee 束 以 便 将 检查 请 求 头 的 任务 
委托 给 通过 service provider 获 取 的 
UserAgentComparer 对 象 。 


代码 清单 31-25 ”在 Infrastructure 文 件 夹 下 的 
UserAgentAttribute.cs 文 件 中 解决 依赖 问题 





using System; 

using System.Ling; 

using Microsoft.AspNetCore.Mvc.ActionConstraints; 
using Microsoft.Extensions .DependencyInjection; 


namespace ConventionsAndConstraints.Infrastructure { 


public class UserAgentAttribute : Attribute, IActio 
nConstraintFactory { 
private string substring; 


public UserAgentAttribute(string sub) { 
substring = sub; 


} 


public IActionConstraint CreateInstance(IServic 
eProvider services) { 
return new UserAgentConstraint(services.Get 
Service<UserAgentComparer>(), 


substring) ; 


} 


public bool IsReusable => false; 


private class UserAgentConstraint : IActionCons 
traint { 
private UserAgentComparer comparer; 
private string substring; 


public UserAgentConstraint (UserAgentCompare 
r comp, string sub) { 
comparer = comp; 
substring = sub.ToLower(); 


} 
public int Order { get; set; } = @; 


public bool Accept(ActionConstraintContext 


context) { 
return comparer.ContainsString(context. 
RouteContext 
.HttpContext.Request, substring 
) 


|| context.Candidates.Count() == 1; 





在 以 上 模型 中 ， 应 用 于 操作 方法 的 特性 负责 在 
调用 CreateInstance 方 法 时 创建 约束 类 的 实例 。 








CreateInstance 方 法 的 参数 是 一 个 IserviceProvider 对 
象 ， 本 例 使 用 了 UserAgentComparer， 以 便 可 以 创 
建 私 有 约束 类 的 实例 ， 然 后 在 选择 过 程 中 使 用 。 


避免 范围 陷阱 


与 其 他 基于 特性 的 功能 一 样 ， 将 约束 特性 应 用 
于 控制 占 类 等 同 于 将 约束 特性 应 用 于 每 个 独立 的 方 
法 。 然 而 ， 这 通常 会 导致 未 预期 的 结果 ， 因 为 操作 
约束 的 目的 是 帮助 MVC 选 择 操作 方法 ， 而 不 是 对 控 
制 工 中 所 有 的 操作 方法 应 用 相同 的 约束 。 





例如 ， 如 果 将 UserAgent 特 性 应 用 于 
HomeController 类 ， 那 么 任何 浏览 器 都 将 无 法 访问 
Index 这 个 操作 方法 。 两 个 Index 操 作 方 法 都 同样 适 
用 于 处 理 User-Agent 字 符 串 中 包含 Edge 的 浏览 器 ， 
这 将 导致 民利 。 对 于 所 有 其 他 的 浏览 器 ， 这 两 个 


Index 操 作 方 法 都 不 合适 ， 这 将 导致 404-Not Found 
Ha] AY o 


使 用 约束 中 的 上 下 文 对 象 可 以 但 找 其 他 的 约 
束 ， 并 得 看 它们 是 侣 可 能 拒绝 请 求 ， 但 这 会 导致 每 
个 约束 的 Accept 方 法 和 梓 调 用 多 次 。 当 有 多 个 操作 方 
法 可 以 处 理 相同 的 请 求 时 ， 可 将 约束 应 用 于 这 些 操 
作 方 法 ， 此 时 最 有 效 。 


31.4 小结 


本 章 描 述 了 两 个 用 于 定制 MVC 运 行 方式 的 特 
性 ， 解 释 了 如 何 使 用 模型 约束 来 改变 将 类 和 方法 映 
财 到 控制 费 和 操作 的 方式 ， 还 讲述 了 如 何 使 用 操作 
约束 来 限制 操作 方法 可 能 处 理 的 请 求 的 范围 ， 以 及 
如 何 使 用 它们 在 请 求 到 达 时 从 识别 的 候选 列表 中 选 


择 一 个 操作 方法 。 


本 书 从 创建 一 个 简单 的 应 用 程序 开始 ， 带 你 全 
面 了 解 了 ASP.NET Core MVC 框 架 中 不 同 的 组 件 ， 
理解 如 何 配置 、 定 制 或 完全 符 换 它们 。 














最 后 ， 祝 你 在 MVC 项 目 中 取得 圆满 成 功 ! 


